HTML email context

diff --git a/.gitignore b/.gitignore index 94f1119e..5d0abbe7 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,108 @@ .DS_Store .vscode +export + +# Byte-compiled / optimized / DLL files +__pycache__/ +*.py[cod] +*$py.class + +# C extensions +*.so + +# Distribution / packaging +.Python +build/ +develop-eggs/ +dist/ +downloads/ +eggs/ +.eggs/ +lib64/ +parts/ +sdist/ +var/ +wheels/ +*.egg-info/ +.installed.cfg +*.egg +MANIFEST + +# PyInstaller +# Usually these files are written by a python script from a template +# before PyInstaller builds the exe, so as to inject date/other infos into it. +*.manifest +*.spec + +# Installer logs +pip-log.txt +pip-delete-this-directory.txt + +# Unit test / coverage reports +htmlcov/ +.tox/ +.coverage +.coverage.* +.cache +nosetests.xml +coverage.xml +*.cover +.hypothesis/ +.pytest_cache/ + +# Translations +*.mo +*.pot + +# Django stuff: +*.log +local_settings.py +db.sqlite3 + +# Flask stuff: +instance/ +.webassets-cache + +# Scrapy stuff: +.scrapy + +# Sphinx documentation +docs/_build/ + +# PyBuilder +target/ + +# Jupyter Notebook +.ipynb_checkpoints + +# pyenv +.python-version + +# celery beat schedule file +celerybeat-schedule + +# SageMath parsed files +*.sage.py + +# Environments +.env +.venv +env/ +venv/ +ENV/ +env.bak/ +venv.bak/ + +# Spyder project settings +.spyderproject +.spyproject + +# Rope project settings +.ropeproject + +# mkdocs documentation +/site + +# mypy +.mypy_cache/ + diff --git a/Makefile b/Makefile new file mode 100644 index 00000000..59746512 --- /dev/null +++ b/Makefile @@ -0,0 +1,19 @@ +SHELL = /usr/bin/env bash -xe + +PWD := $(shell pwd) + +build: + @rm -rf export + @mkdir export + @zip -yr export/layer.zip bootstrap bin lib libexec share + +publish: + @$(PWD)/publish.sh + +publish-staging: + @$(PWD)/publish-staging.sh + +.PHONY: \ + build + publish + publish-staging \ No newline at end of file diff --git a/README.md b/README.md index 5aada21f..cd2c9034 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,11 @@ # Bash in AWS Lambda +## NO LONGER SUPPORTED + +This repository and layer is no longer receiving updates or support. I've been too busy to keep up with changes in the Lambda environment and this has fallen behind. Use at your own risk. + +--- + Run Bash in [AWS Lambda](https://aws.amazon.com/lambda/) via [Layers](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html). This Layer is 100% Bash and handles all communication with the Lambda Runtime API. This allows you to run full Bash scripts and commands inside of AWS Lambda. This Layer also includes common CLI tools used in Bash scripts. See the [How To](#how-to) section to understand how to use these layers. Also see the [example-basic.sh](examples/example-basic.sh) file for an example of how to write a Bash script compatible with this Layer. @@ -7,7 +13,7 @@ See the [How To](#how-to) section to understand how to use these layers. Also se ### ARN ``` -arn:aws:lambda::744348701589:layer:bash:3 +arn:aws:lambda::744348701589:layer:bash:8 ``` ## How To @@ -36,7 +42,7 @@ $ aws lambda create-function \ --role bashFunctionRole \ --handler index.handler \ --runtime provided \ - --layers arn:aws:lambda::744348701589:layer:bash:3 \ + --layers arn:aws:lambda::744348701589:layer:bash:8 \ --zip-file fileb://function.zip ``` @@ -61,7 +67,7 @@ $ aws lambda create-function \ ``` $ aws lambda update-function-configuration \ --function-name bashFunction \ - --layers arn:aws:lambda::744348701589:layer:bash:3 + --layers arn:aws:lambda::744348701589:layer:bash:8 ``` ### Writing Scripts @@ -140,22 +146,59 @@ Bash behaves in ways unlike other programming languages. As such, there are some `AWS_LAMBDA_TRACE_ID` - The sampling decision, trace ID, and parent segment ID of AWS XRay +### Building + +To build a layer, simply run `make build`. This will create a zip archive of the layer in the `export/` directory. + +### Publishing + +To publish the layer to the public, simply run `make publish`. This will create a new version of the layer from the `export/layer.zip` file (create from the Build step) and give it a global read permission. + +### Adding New Executables + +Some executables are able to run by themselves and some require additional dependencies that are present on the server. It's hard to cover here case here, but if the executable run by itself it can easily be added. If it has dependencies, you must explore what those dependencies are and how to add them to the layer as well. + +You can either add the executable from an Amazon Linux AMI or from the [lambci/lambda:build-python3.6](https://github.com/lambci/docker-lambda) Docker image. + +_Disclaimer: I usually don't add in executables from pull requests for security reasons. If you would like to see an executable in this layer make an issue and I'll try to add it._ + ### Included Executables - `$ aws` +- `$ bc` - `$ git` - `$ jq` +- `$ rsync` - `$ scp` - `$ sftp` - `$ ssh` +- `$ sshpass` +- `$ time` +- `$ traceroute` +- `$ tree` - `$ wget` +- `$ vim` - `$ zip` +- `$ unzip` **Already included in the Lambda environment:** +- `$ awk` +- `$ cat` - `$ curl` +- `$ cut` +- `$ date` +- `$ diff` +- `$ grep` - `$ gzip` +- `$ head` +- `$ md5sum` +- `$ pwd` +- `$ sed` - `$ tar` +- `$ tail` +- `$ tee` +- `$ xargs` _If you would like to see more, please create an issue._ diff --git a/bin/PyYAML-3.13.dist-info/DESCRIPTION.rst b/bin/PyYAML-3.13.dist-info/DESCRIPTION.rst deleted file mode 100644 index 94d55d33..00000000 --- a/bin/PyYAML-3.13.dist-info/DESCRIPTION.rst +++ /dev/null @@ -1,12 +0,0 @@ -YAML is a data serialization format designed for human readability -and interaction with scripting languages. PyYAML is a YAML parser -and emitter for Python. - -PyYAML features a complete YAML 1.1 parser, Unicode support, pickle -support, capable extension API, and sensible error messages. PyYAML -supports standard YAML tags and provides Python-specific tags that -allow to represent an arbitrary Python object. - -PyYAML is applicable for a broad range of tasks from complex -configuration files to object serialization and persistance. - diff --git a/bin/PyYAML-3.13.dist-info/INSTALLER b/bin/PyYAML-3.13.dist-info/INSTALLER deleted file mode 100644 index a1b589e3..00000000 --- a/bin/PyYAML-3.13.dist-info/INSTALLER +++ /dev/null @@ -1 +0,0 @@ -pip diff --git a/bin/PyYAML-3.13.dist-info/METADATA b/bin/PyYAML-3.13.dist-info/METADATA deleted file mode 100644 index 84f822a5..00000000 --- a/bin/PyYAML-3.13.dist-info/METADATA +++ /dev/null @@ -1,35 +0,0 @@ -Metadata-Version: 2.0 -Name: PyYAML -Version: 3.13 -Summary: YAML parser and emitter for Python -Home-page: http://pyyaml.org/wiki/PyYAML -Author: Kirill Simonov -Author-email: xi@resolvent.net -License: MIT -Download-URL: http://pyyaml.org/download/pyyaml/PyYAML-3.13.tar.gz -Platform: Any -Classifier: Development Status :: 5 - Production/Stable -Classifier: Intended Audience :: Developers -Classifier: License :: OSI Approved :: MIT License -Classifier: Operating System :: OS Independent -Classifier: Programming Language :: Python -Classifier: Programming Language :: Python :: 2 -Classifier: Programming Language :: Python :: 2.7 -Classifier: Programming Language :: Python :: 3 -Classifier: Programming Language :: Python :: 3.4 -Classifier: Programming Language :: Python :: 3.5 -Classifier: Topic :: Software Development :: Libraries :: Python Modules -Classifier: Topic :: Text Processing :: Markup - -YAML is a data serialization format designed for human readability -and interaction with scripting languages. PyYAML is a YAML parser -and emitter for Python. - -PyYAML features a complete YAML 1.1 parser, Unicode support, pickle -support, capable extension API, and sensible error messages. PyYAML -supports standard YAML tags and provides Python-specific tags that -allow to represent an arbitrary Python object. - -PyYAML is applicable for a broad range of tasks from complex -configuration files to object serialization and persistance. - diff --git a/bin/PyYAML-3.13.dist-info/RECORD b/bin/PyYAML-3.13.dist-info/RECORD deleted file mode 100644 index 04691b28..00000000 --- a/bin/PyYAML-3.13.dist-info/RECORD +++ /dev/null @@ -1,41 +0,0 @@ -PyYAML-3.13.dist-info/DESCRIPTION.rst,sha256=4nzkrOwMTYfusIfdRz4-dl_9Blan5axHPKMiVJEOV-4,534 -PyYAML-3.13.dist-info/METADATA,sha256=U0dUImL7hk_qDCAP0kWKM2_ECiVADYEJNjcAiiaDFxM,1424 -PyYAML-3.13.dist-info/RECORD,, -PyYAML-3.13.dist-info/WHEEL,sha256=b3UV3fudrHl-yDcvYrRzgHdeWy9pAZ--T8TfFPEbJgY,111 -PyYAML-3.13.dist-info/metadata.json,sha256=qc4uIWakd1-A2fUIChRA9_gfnjYR2dU7ChyEhLilO8Y,1013 -PyYAML-3.13.dist-info/top_level.txt,sha256=rpj0IVMTisAjh_1vG3Ccf9v5jpCQwAz6cD1IVU5ZdhQ,11 -yaml/__init__.py,sha256=Qz7WIGATMtHvmu_vLmCcFTaiyZn5ptv2rsNGsdzlnbc,9776 -yaml/composer.py,sha256=pOjZ5afqNfH22WXyS6xlQCB2PbSrFPjK-qFPOEI76fw,4921 -yaml/constructor.py,sha256=S_Pux76-hgmgtJeJVtSvQ9ynmtEIR2jAx2ljAochKU0,25145 -yaml/cyaml.py,sha256=xK_IxkrRcetZeNwB_wzDAHYCWsumOFfsTlk3CeoM5kQ,3290 -yaml/dumper.py,sha256=ONPYNHirnLm-qCm-h9swnMWzZhncilexboIPRoNdcq4,2719 -yaml/emitter.py,sha256=Xya7zhTX3ykxMAdAgDIedejmLb1Q71W2G4yt4nTSMIM,43298 -yaml/error.py,sha256=7K-NdIv0qNKPKbnXxEg0L_b9K7nYDORr3rzm8_b-iBY,2559 -yaml/events.py,sha256=50_TksgQiE4up-lKo_V-nBy-tAIxkIPQxY5qDhKCeHw,2445 -yaml/loader.py,sha256=t_WLbw1-iWQ4KT_FUppJu30cFIU-l8NCb7bjoXJoV6A,1132 -yaml/nodes.py,sha256=gPKNj8pKCdh2d4gr3gIYINnPOaOxGhJAUiYhGRnPE84,1440 -yaml/parser.py,sha256=sgXahZA3DkySYnaC4D_zcl3l2y4Y5R40icWtdwkF_NE,25542 -yaml/reader.py,sha256=hKuxSbid1rSlfKBsshf5qaPwVduaCJA5t5S9Jum6CAA,6746 -yaml/representer.py,sha256=x3F9vDF4iiPit8sR8tgR-kjtotWTzH_Zv9moq0fMtlY,17711 -yaml/resolver.py,sha256=5Z3boiMikL6Qt6fS5Mt8fHym0GxbW7CMT2f2fnD1ZPQ,9122 -yaml/scanner.py,sha256=ft5i4fP9m0MrpKY9N8Xa24H1LqKhwGQXLG1Hd9gCSsk,52446 -yaml/serializer.py,sha256=tRsRwfu5E9fpLU7LY3vBQf2prt77hwnYlMt5dnBJLig,4171 -yaml/tokens.py,sha256=lTQIzSVw8Mg9wv459-TjiOQe6wVziqaRlqX2_89rp54,2573 -PyYAML-3.13.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 -yaml/loader.pyc,, -yaml/__init__.pyc,, -yaml/cyaml.pyc,, -yaml/resolver.pyc,, -yaml/reader.pyc,, -yaml/dumper.pyc,, -yaml/constructor.pyc,, -yaml/scanner.pyc,, -yaml/serializer.pyc,, -yaml/nodes.pyc,, -yaml/events.pyc,, -yaml/representer.pyc,, -yaml/error.pyc,, -yaml/tokens.pyc,, -yaml/parser.pyc,, -yaml/composer.pyc,, -yaml/emitter.pyc,, diff --git a/bin/PyYAML-3.13.dist-info/WHEEL b/bin/PyYAML-3.13.dist-info/WHEEL deleted file mode 100644 index 7d7a7cff..00000000 --- a/bin/PyYAML-3.13.dist-info/WHEEL +++ /dev/null @@ -1,5 +0,0 @@ -Wheel-Version: 1.0 -Generator: bdist_wheel (0.29.0) -Root-Is-Purelib: false -Tag: cp27-cp27m-macosx_10_12_x86_64 - diff --git a/bin/PyYAML-3.13.dist-info/metadata.json b/bin/PyYAML-3.13.dist-info/metadata.json deleted file mode 100644 index 45c21b35..00000000 --- a/bin/PyYAML-3.13.dist-info/metadata.json +++ /dev/null @@ -1 +0,0 @@ -{"classifiers": ["Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Text Processing :: Markup"], "download_url": "http://pyyaml.org/download/pyyaml/PyYAML-3.13.tar.gz", "extensions": {"python.details": {"contacts": [{"email": "xi@resolvent.net", "name": "Kirill Simonov", "role": "author"}], "document_names": {"description": "DESCRIPTION.rst"}, "project_urls": {"Home": "http://pyyaml.org/wiki/PyYAML"}}}, "generator": "bdist_wheel (0.29.0)", "license": "MIT", "metadata_version": "2.0", "name": "PyYAML", "platform": "Any", "summary": "YAML parser and emitter for Python", "version": "3.13"} \ No newline at end of file diff --git a/bin/PyYAML-3.13.dist-info/top_level.txt b/bin/PyYAML-3.13.dist-info/top_level.txt deleted file mode 100644 index e6475e91..00000000 --- a/bin/PyYAML-3.13.dist-info/top_level.txt +++ /dev/null @@ -1,2 +0,0 @@ -_yaml -yaml diff --git a/bin/aws b/bin/aws index a9e4eaaa..79e85e17 100755 --- a/bin/aws +++ b/bin/aws @@ -1,4 +1,4 @@ -#!/usr/bin/python +#!/usr/bin/python3 # Copyright 2012 Amazon.com, Inc. or its affiliates. All Rights Reserved. # Licensed under the Apache License, Version 2.0 (the "License"). You diff --git a/bin/awscli-1.16.71.dist-info/DESCRIPTION.rst b/bin/awscli-1.16.71.dist-info/DESCRIPTION.rst deleted file mode 100644 index 504a86ed..00000000 --- a/bin/awscli-1.16.71.dist-info/DESCRIPTION.rst +++ /dev/null @@ -1,440 +0,0 @@ -======= -aws-cli -======= - -.. image:: https://travis-ci.org/aws/aws-cli.svg?branch=develop - :target: https://travis-ci.org/aws/aws-cli - :alt: Build Status - -.. image:: https://badges.gitter.im/aws/aws-cli.svg - :target: https://gitter.im/aws/aws-cli - :alt: Gitter - - -This package provides a unified command line interface to Amazon Web Services. - -The aws-cli package works on Python versions: - -* 2.6.5 and greater -* 2.7.x and greater -* 3.3.x and greater -* 3.4.x and greater -* 3.5.x and greater -* 3.6.x and greater -* 3.7.x and greater - -.. attention:: - We recommend that all customers regularly monitor the - `Amazon Web Services Security Bulletins website`_ for any important security bulletins related to - aws-cli. - - ------------- -Installation ------------- - -The easiest way to install aws-cli is to use `pip`_ in a ``virtualenv``:: - - $ pip install awscli - -or, if you are not installing in a ``virtualenv``, to install globally:: - - $ sudo pip install awscli - -or for your user:: - - $ pip install --user awscli - -If you have the aws-cli installed and want to upgrade to the latest version -you can run:: - - $ pip install --upgrade awscli - -.. note:: - - On OS X, if you see an error regarding the version of six that came with - distutils in El Capitan, use the ``--ignore-installed`` option:: - - $ sudo pip install awscli --ignore-installed six - - -This will install the aws-cli package as well as all dependencies. You can -also just `download the tarball`_. Once you have the -awscli directory structure on your workstation, you can just run:: - - $ cd - $ python setup.py install - -If you want to run the ``develop`` branch of the CLI, see the -"CLI Dev Version" section below. - - ------------- -CLI Releases ------------- - -The release notes for the AWS CLI can be found `here `__. - - ------------------- -Command Completion ------------------- - -The aws-cli package includes a very useful command completion feature. -This feature is not automatically installed so you need to configure it manually. -To enable tab completion for bash either use the built-in command ``complete``:: - - $ complete -C aws_completer aws - -Or add ``bin/aws_bash_completer`` file under ``/etc/bash_completion.d``, -``/usr/local/etc/bash_completion.d`` or any other ``bash_completion.d`` location. - -For tcsh:: - - $ complete aws 'p/*/`aws_completer`/' - -You should add this to your startup scripts to enable it for future sessions. - -For zsh please refer to ``bin/aws_zsh_completer.sh``. Source that file, e.g. -from your ``~/.zshrc``, and make sure you run ``compinit`` before:: - - $ source bin/aws_zsh_completer.sh - -For now the bash compatibility auto completion (``bashcompinit``) is used. -For further details please refer to the top of ``bin/aws_zsh_completer.sh``. - ---------------- -Getting Started ---------------- - -Before using aws-cli, you need to tell it about your AWS credentials. You -can do this in several ways: - -* Environment variables -* Shared credentials file -* Config file -* IAM Role - -The quickest way to get started is to run the ``aws configure`` command:: - - $ aws configure - AWS Access Key ID: foo - AWS Secret Access Key: bar - Default region name [us-west-2]: us-west-2 - Default output format [None]: json - -To use environment variables, do the following:: - - $ export AWS_ACCESS_KEY_ID= - $ export AWS_SECRET_ACCESS_KEY= - -To use the shared credentials file, create an INI formatted file like this:: - - [default] - aws_access_key_id=foo - aws_secret_access_key=bar - - [testing] - aws_access_key_id=foo - aws_secret_access_key=bar - -and place it in ``~/.aws/credentials`` (or in -``%UserProfile%\.aws/credentials`` on Windows). If you wish to place the -shared credentials file in a different location than the one specified above, -you need to tell aws-cli where to find it. Do this by setting -the appropriate environment variable:: - - $ export AWS_SHARED_CREDENTIALS_FILE=/path/to/shared_credentials_file - -To use a config file, create a configuration file like this:: - - [default] - aws_access_key_id= - aws_secret_access_key= - # Optional, to define default region for this profile. - region=us-west-1 - - [profile testing] - aws_access_key_id= - aws_secret_access_key= - region=us-west-2 - -and place it in ``~/.aws/config`` (or in ``%UserProfile%\.aws\config`` on Windows). If you wish to place the config file in a different location than the one -specified above, you need to tell aws-cli where to find it. Do this by setting -the appropriate environment variable:: - - $ export AWS_CONFIG_FILE=/path/to/config_file - -As you can see, you can have multiple ``profiles`` defined in both the shared -credentials file and the configuration file. You can then specify which -profile to use by using the ``--profile`` option. If no profile is specified -the ``default`` profile is used. - -In the config file, except for the default profile, you -**must** prefix each config section of a profile group with ``profile``. -For example, if you have a profile named "testing" the section header would -be ``[profile testing]``. - -The final option for credentials is highly recommended if you are -using aws-cli on an EC2 instance. IAM Roles are -a great way to have credentials installed automatically on your -instance. If you are using IAM Roles, aws-cli will find them and use -them automatically. - ----------------------------- -Other Configurable Variables ----------------------------- - -In addition to credentials, a number of other variables can be -configured either with environment variables, configuration file -entries or both. The following table documents these. - -============================= =========== ============================= ================================= ================================== -Variable Option Config Entry Environment Variable Description -============================= =========== ============================= ================================= ================================== -profile --profile profile AWS_PROFILE Default profile name ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -region --region region AWS_DEFAULT_REGION Default AWS Region ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -config_file AWS_CONFIG_FILE Alternate location of config ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -credentials_file AWS_SHARED_CREDENTIALS_FILE Alternate location of credentials ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -output --output output AWS_DEFAULT_OUTPUT Default output style ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -ca_bundle --ca-bundle ca_bundle AWS_CA_BUNDLE CA Certificate Bundle ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -access_key aws_access_key_id AWS_ACCESS_KEY_ID AWS Access Key ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -secret_key aws_secret_access_key AWS_SECRET_ACCESS_KEY AWS Secret Key ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -token aws_session_token AWS_SESSION_TOKEN AWS Token (temp credentials) ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -cli_timestamp_format cli_timestamp_format Output format of timestamps ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -metadata_service_timeout metadata_service_timeout AWS_METADATA_SERVICE_TIMEOUT EC2 metadata timeout ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -metadata_service_num_attempts metadata_service_num_attempts AWS_METADATA_SERVICE_NUM_ATTEMPTS EC2 metadata retry count ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -parameter_validation parameter_validation Toggles local parameter validation -============================= =========== ============================= ================================= ================================== - -^^^^^^^^ -Examples -^^^^^^^^ - -If you get tired of specifying a ``--region`` option on the command line -all of the time, you can specify a default region to use whenever no -explicit ``--region`` option is included using the ``region`` variable. -To specify this using an environment variable:: - - $ export AWS_DEFAULT_REGION=us-west-2 - -To include it in your config file:: - - [default] - aws_access_key_id= - aws_secret_access_key= - region=us-west-1 - -Similarly, the ``profile`` variable can be used to specify which profile to use -if one is not explicitly specified on the command line via the -``--profile`` option. To set this via environment variable:: - - $ export AWS_PROFILE=testing - -The ``profile`` variable can not be specified in the configuration file -since it would have to be associated with a profile and would defeat the -purpose. - -^^^^^^^^^^^^^^^^^^^ -Further Information -^^^^^^^^^^^^^^^^^^^ - -For more information about configuration options, please refer the -`AWS CLI Configuration Variables topic `_. You can access this topic -from the CLI as well by running ``aws help config-vars``. - - ----------------------------------------- -Accessing Services With Global Endpoints ----------------------------------------- - -Some services, such as *AWS Identity and Access Management* (IAM) -have a single, global endpoint rather than different endpoints for -each region. - -To make access to these services simpler, aws-cli will automatically -use the global endpoint unless you explicitly supply a region (using -the ``--region`` option) or a profile (using the ``--profile`` option). -Therefore, the following:: - - $ aws iam list-users - -will automatically use the global endpoint for the IAM service -regardless of the value of the ``AWS_DEFAULT_REGION`` environment -variable or the ``region`` variable specified in your profile. - --------------------- -JSON Parameter Input --------------------- - -Many options that need to be provided are simple string or numeric -values. However, some operations require JSON data structures -as input parameters either on the command line or in files. - -For example, consider the command to authorize access to an EC2 -security group. In this case, we will add ingress access to port 22 -for all IP addresses:: - - $ aws ec2 authorize-security-group-ingress --group-name MySecurityGroup \ - --ip-permissions '{"FromPort":22,"ToPort":22,"IpProtocol":"tcp","IpRanges":[{"CidrIp": "0.0.0.0/0"}]}' - --------------------------- -File-based Parameter Input --------------------------- - -Some parameter values are so large or so complex that it would be easier -to place the parameter value in a file and refer to that file rather than -entering the value directly on the command line. - -Let's use the ``authorize-security-group-ingress`` command shown above. -Rather than provide the value of the ``--ip-permissions`` parameter directly -in the command, you could first store the values in a file. Let's call -the file ``ip_perms.json``:: - - {"FromPort":22, - "ToPort":22, - "IpProtocol":"tcp", - "IpRanges":[{"CidrIp":"0.0.0.0/0"}]} - -Then, we could make the same call as above like this:: - - $ aws ec2 authorize-security-group-ingress --group-name MySecurityGroup \ - --ip-permissions file://ip_perms.json - -The ``file://`` prefix on the parameter value signals that the parameter value -is actually a reference to a file that contains the actual parameter value. -aws-cli will open the file, read the value and use that value as the -parameter value. - -This is also useful when the parameter is really referring to file-based -data. For example, the ``--user-data`` option of the ``aws ec2 run-instances`` -command or the ``--public-key-material`` parameter of the -``aws ec2 import-key-pair`` command. - -------------------------- -URI-based Parameter Input -------------------------- - -Similar to the file-based input described above, aws-cli also includes a -way to use data from a URI as the value of a parameter. The idea is exactly -the same except the prefix used is ``https://`` or ``http://``:: - - $ aws ec2 authorize-security-group-ingress --group-name MySecurityGroup \ - --ip-permissions http://mybucket.s3.amazonaws.com/ip_perms.json - --------------- -Command Output --------------- - -The default output for commands is currently JSON. You can use the -``--query`` option to extract the output elements from this JSON document. -For more information on the expression language used for the ``--query`` -argument, you can read the -`JMESPath Tutorial `__. - -^^^^^^^^ -Examples -^^^^^^^^ - -Get a list of IAM user names:: - - $ aws iam list-users --query Users[].UserName - -Get a list of key names and their sizes in an S3 bucket:: - - $ aws s3api list-objects --bucket b --query Contents[].[Key,Size] - -Get a list of all EC2 instances and include their Instance ID, State Name, -and their Name (if they've been tagged with a Name):: - - $ aws ec2 describe-instances --query \ - 'Reservations[].Instances[].[InstanceId,State.Name,Tags[?Key==`Name`] | [0].Value]' - - -You may also find the `jq `_ tool useful in -processing the JSON output for other uses. - -There is also an ASCII table format available. You can select this style with -the ``--output table`` option or you can make this style your default output -style via environment variable or config file entry as described above. -Try adding ``--output table`` to the above commands. - - ---------------- -CLI Dev Version ---------------- - -If you are just interested in using the latest released version of the AWS CLI, -please see the Installation_ section above. This section is for anyone who -wants to install the development version of the CLI. You normally would not -need to do this unless: - -* You are developing a feature for the CLI and plan on submitting a Pull - Request. -* You want to test the latest changes of the CLI before they make it into an - official release. - -The latest changes to the CLI are in the ``develop`` branch on github. This is -the default branch when you clone the git repository. - -Additionally, there are several other packages that are developed in lockstep -with the CLI. This includes: - -* `botocore `__ -* `jmespath `__ - -If you just want to install a snapshot of the latest development version of -the CLI, you can use the ``requirements.txt`` file included in this repo. -This file points to the development version of the above packages:: - - cd - pip install -r requirements.txt - pip install -e . - -However, to keep up to date, you will continually have to run the -``pip install -r requirements.txt`` file to pull in the latest changes -from the develop branches of botocore, jmespath, etc. - -You can optionally clone each of those repositories and run "pip install -e ." -for each repository:: - - git clone && cd jmespath/ - pip install -e . && cd .. - git clone && cd botocore/ - pip install -e . && cd .. - git clone && cd aws-cli/ - pip install -e . - - ------------- -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 `aws-cli `__ -* Come join the AWS CLI 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 `__ - - - -.. _`Amazon Web Services Security Bulletins website`: https://aws.amazon.com/security/security-bulletins -.. _pip: http://www.pip-installer.org/en/latest/ -.. _`download the tarball`: https://pypi.org/project/awscli/ - - diff --git a/bin/awscli-1.16.71.dist-info/INSTALLER b/bin/awscli-1.16.71.dist-info/INSTALLER deleted file mode 100644 index a1b589e3..00000000 --- a/bin/awscli-1.16.71.dist-info/INSTALLER +++ /dev/null @@ -1 +0,0 @@ -pip diff --git a/bin/awscli-1.16.71.dist-info/METADATA b/bin/awscli-1.16.71.dist-info/METADATA deleted file mode 100644 index 2b7f1616..00000000 --- a/bin/awscli-1.16.71.dist-info/METADATA +++ /dev/null @@ -1,472 +0,0 @@ -Metadata-Version: 2.0 -Name: awscli -Version: 1.16.71 -Summary: Universal Command Line Environment for AWS. -Home-page: http://aws.amazon.com/cli/ -Author: Amazon Web Services -Author-email: UNKNOWN -License: Apache License 2.0 -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 -Requires-Dist: botocore==1.12.61 -Requires-Dist: colorama>=0.2.5,<=0.3.9 -Requires-Dist: docutils>=0.10 -Requires-Dist: rsa>=3.1.2,<=3.5.0 -Requires-Dist: PyYAML>=3.10,<=3.13 -Requires-Dist: s3transfer>=0.1.12,<0.2.0 -Requires-Dist: argparse>=1.1; python_version=="2.6" - -======= -aws-cli -======= - -.. image:: https://travis-ci.org/aws/aws-cli.svg?branch=develop - :target: https://travis-ci.org/aws/aws-cli - :alt: Build Status - -.. image:: https://badges.gitter.im/aws/aws-cli.svg - :target: https://gitter.im/aws/aws-cli - :alt: Gitter - - -This package provides a unified command line interface to Amazon Web Services. - -The aws-cli package works on Python versions: - -* 2.6.5 and greater -* 2.7.x and greater -* 3.3.x and greater -* 3.4.x and greater -* 3.5.x and greater -* 3.6.x and greater -* 3.7.x and greater - -.. attention:: - We recommend that all customers regularly monitor the - `Amazon Web Services Security Bulletins website`_ for any important security bulletins related to - aws-cli. - - ------------- -Installation ------------- - -The easiest way to install aws-cli is to use `pip`_ in a ``virtualenv``:: - - $ pip install awscli - -or, if you are not installing in a ``virtualenv``, to install globally:: - - $ sudo pip install awscli - -or for your user:: - - $ pip install --user awscli - -If you have the aws-cli installed and want to upgrade to the latest version -you can run:: - - $ pip install --upgrade awscli - -.. note:: - - On OS X, if you see an error regarding the version of six that came with - distutils in El Capitan, use the ``--ignore-installed`` option:: - - $ sudo pip install awscli --ignore-installed six - - -This will install the aws-cli package as well as all dependencies. You can -also just `download the tarball`_. Once you have the -awscli directory structure on your workstation, you can just run:: - - $ cd - $ python setup.py install - -If you want to run the ``develop`` branch of the CLI, see the -"CLI Dev Version" section below. - - ------------- -CLI Releases ------------- - -The release notes for the AWS CLI can be found `here `__. - - ------------------- -Command Completion ------------------- - -The aws-cli package includes a very useful command completion feature. -This feature is not automatically installed so you need to configure it manually. -To enable tab completion for bash either use the built-in command ``complete``:: - - $ complete -C aws_completer aws - -Or add ``bin/aws_bash_completer`` file under ``/etc/bash_completion.d``, -``/usr/local/etc/bash_completion.d`` or any other ``bash_completion.d`` location. - -For tcsh:: - - $ complete aws 'p/*/`aws_completer`/' - -You should add this to your startup scripts to enable it for future sessions. - -For zsh please refer to ``bin/aws_zsh_completer.sh``. Source that file, e.g. -from your ``~/.zshrc``, and make sure you run ``compinit`` before:: - - $ source bin/aws_zsh_completer.sh - -For now the bash compatibility auto completion (``bashcompinit``) is used. -For further details please refer to the top of ``bin/aws_zsh_completer.sh``. - ---------------- -Getting Started ---------------- - -Before using aws-cli, you need to tell it about your AWS credentials. You -can do this in several ways: - -* Environment variables -* Shared credentials file -* Config file -* IAM Role - -The quickest way to get started is to run the ``aws configure`` command:: - - $ aws configure - AWS Access Key ID: foo - AWS Secret Access Key: bar - Default region name [us-west-2]: us-west-2 - Default output format [None]: json - -To use environment variables, do the following:: - - $ export AWS_ACCESS_KEY_ID= - $ export AWS_SECRET_ACCESS_KEY= - -To use the shared credentials file, create an INI formatted file like this:: - - [default] - aws_access_key_id=foo - aws_secret_access_key=bar - - [testing] - aws_access_key_id=foo - aws_secret_access_key=bar - -and place it in ``~/.aws/credentials`` (or in -``%UserProfile%\.aws/credentials`` on Windows). If you wish to place the -shared credentials file in a different location than the one specified above, -you need to tell aws-cli where to find it. Do this by setting -the appropriate environment variable:: - - $ export AWS_SHARED_CREDENTIALS_FILE=/path/to/shared_credentials_file - -To use a config file, create a configuration file like this:: - - [default] - aws_access_key_id= - aws_secret_access_key= - # Optional, to define default region for this profile. - region=us-west-1 - - [profile testing] - aws_access_key_id= - aws_secret_access_key= - region=us-west-2 - -and place it in ``~/.aws/config`` (or in ``%UserProfile%\.aws\config`` on Windows). If you wish to place the config file in a different location than the one -specified above, you need to tell aws-cli where to find it. Do this by setting -the appropriate environment variable:: - - $ export AWS_CONFIG_FILE=/path/to/config_file - -As you can see, you can have multiple ``profiles`` defined in both the shared -credentials file and the configuration file. You can then specify which -profile to use by using the ``--profile`` option. If no profile is specified -the ``default`` profile is used. - -In the config file, except for the default profile, you -**must** prefix each config section of a profile group with ``profile``. -For example, if you have a profile named "testing" the section header would -be ``[profile testing]``. - -The final option for credentials is highly recommended if you are -using aws-cli on an EC2 instance. IAM Roles are -a great way to have credentials installed automatically on your -instance. If you are using IAM Roles, aws-cli will find them and use -them automatically. - ----------------------------- -Other Configurable Variables ----------------------------- - -In addition to credentials, a number of other variables can be -configured either with environment variables, configuration file -entries or both. The following table documents these. - -============================= =========== ============================= ================================= ================================== -Variable Option Config Entry Environment Variable Description -============================= =========== ============================= ================================= ================================== -profile --profile profile AWS_PROFILE Default profile name ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -region --region region AWS_DEFAULT_REGION Default AWS Region ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -config_file AWS_CONFIG_FILE Alternate location of config ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -credentials_file AWS_SHARED_CREDENTIALS_FILE Alternate location of credentials ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -output --output output AWS_DEFAULT_OUTPUT Default output style ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -ca_bundle --ca-bundle ca_bundle AWS_CA_BUNDLE CA Certificate Bundle ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -access_key aws_access_key_id AWS_ACCESS_KEY_ID AWS Access Key ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -secret_key aws_secret_access_key AWS_SECRET_ACCESS_KEY AWS Secret Key ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -token aws_session_token AWS_SESSION_TOKEN AWS Token (temp credentials) ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -cli_timestamp_format cli_timestamp_format Output format of timestamps ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -metadata_service_timeout metadata_service_timeout AWS_METADATA_SERVICE_TIMEOUT EC2 metadata timeout ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -metadata_service_num_attempts metadata_service_num_attempts AWS_METADATA_SERVICE_NUM_ATTEMPTS EC2 metadata retry count ------------------------------ ----------- ----------------------------- --------------------------------- ---------------------------------- -parameter_validation parameter_validation Toggles local parameter validation -============================= =========== ============================= ================================= ================================== - -^^^^^^^^ -Examples -^^^^^^^^ - -If you get tired of specifying a ``--region`` option on the command line -all of the time, you can specify a default region to use whenever no -explicit ``--region`` option is included using the ``region`` variable. -To specify this using an environment variable:: - - $ export AWS_DEFAULT_REGION=us-west-2 - -To include it in your config file:: - - [default] - aws_access_key_id= - aws_secret_access_key= - region=us-west-1 - -Similarly, the ``profile`` variable can be used to specify which profile to use -if one is not explicitly specified on the command line via the -``--profile`` option. To set this via environment variable:: - - $ export AWS_PROFILE=testing - -The ``profile`` variable can not be specified in the configuration file -since it would have to be associated with a profile and would defeat the -purpose. - -^^^^^^^^^^^^^^^^^^^ -Further Information -^^^^^^^^^^^^^^^^^^^ - -For more information about configuration options, please refer the -`AWS CLI Configuration Variables topic `_. You can access this topic -from the CLI as well by running ``aws help config-vars``. - - ----------------------------------------- -Accessing Services With Global Endpoints ----------------------------------------- - -Some services, such as *AWS Identity and Access Management* (IAM) -have a single, global endpoint rather than different endpoints for -each region. - -To make access to these services simpler, aws-cli will automatically -use the global endpoint unless you explicitly supply a region (using -the ``--region`` option) or a profile (using the ``--profile`` option). -Therefore, the following:: - - $ aws iam list-users - -will automatically use the global endpoint for the IAM service -regardless of the value of the ``AWS_DEFAULT_REGION`` environment -variable or the ``region`` variable specified in your profile. - --------------------- -JSON Parameter Input --------------------- - -Many options that need to be provided are simple string or numeric -values. However, some operations require JSON data structures -as input parameters either on the command line or in files. - -For example, consider the command to authorize access to an EC2 -security group. In this case, we will add ingress access to port 22 -for all IP addresses:: - - $ aws ec2 authorize-security-group-ingress --group-name MySecurityGroup \ - --ip-permissions '{"FromPort":22,"ToPort":22,"IpProtocol":"tcp","IpRanges":[{"CidrIp": "0.0.0.0/0"}]}' - --------------------------- -File-based Parameter Input --------------------------- - -Some parameter values are so large or so complex that it would be easier -to place the parameter value in a file and refer to that file rather than -entering the value directly on the command line. - -Let's use the ``authorize-security-group-ingress`` command shown above. -Rather than provide the value of the ``--ip-permissions`` parameter directly -in the command, you could first store the values in a file. Let's call -the file ``ip_perms.json``:: - - {"FromPort":22, - "ToPort":22, - "IpProtocol":"tcp", - "IpRanges":[{"CidrIp":"0.0.0.0/0"}]} - -Then, we could make the same call as above like this:: - - $ aws ec2 authorize-security-group-ingress --group-name MySecurityGroup \ - --ip-permissions file://ip_perms.json - -The ``file://`` prefix on the parameter value signals that the parameter value -is actually a reference to a file that contains the actual parameter value. -aws-cli will open the file, read the value and use that value as the -parameter value. - -This is also useful when the parameter is really referring to file-based -data. For example, the ``--user-data`` option of the ``aws ec2 run-instances`` -command or the ``--public-key-material`` parameter of the -``aws ec2 import-key-pair`` command. - -------------------------- -URI-based Parameter Input -------------------------- - -Similar to the file-based input described above, aws-cli also includes a -way to use data from a URI as the value of a parameter. The idea is exactly -the same except the prefix used is ``https://`` or ``http://``:: - - $ aws ec2 authorize-security-group-ingress --group-name MySecurityGroup \ - --ip-permissions http://mybucket.s3.amazonaws.com/ip_perms.json - --------------- -Command Output --------------- - -The default output for commands is currently JSON. You can use the -``--query`` option to extract the output elements from this JSON document. -For more information on the expression language used for the ``--query`` -argument, you can read the -`JMESPath Tutorial `__. - -^^^^^^^^ -Examples -^^^^^^^^ - -Get a list of IAM user names:: - - $ aws iam list-users --query Users[].UserName - -Get a list of key names and their sizes in an S3 bucket:: - - $ aws s3api list-objects --bucket b --query Contents[].[Key,Size] - -Get a list of all EC2 instances and include their Instance ID, State Name, -and their Name (if they've been tagged with a Name):: - - $ aws ec2 describe-instances --query \ - 'Reservations[].Instances[].[InstanceId,State.Name,Tags[?Key==`Name`] | [0].Value]' - - -You may also find the `jq `_ tool useful in -processing the JSON output for other uses. - -There is also an ASCII table format available. You can select this style with -the ``--output table`` option or you can make this style your default output -style via environment variable or config file entry as described above. -Try adding ``--output table`` to the above commands. - - ---------------- -CLI Dev Version ---------------- - -If you are just interested in using the latest released version of the AWS CLI, -please see the Installation_ section above. This section is for anyone who -wants to install the development version of the CLI. You normally would not -need to do this unless: - -* You are developing a feature for the CLI and plan on submitting a Pull - Request. -* You want to test the latest changes of the CLI before they make it into an - official release. - -The latest changes to the CLI are in the ``develop`` branch on github. This is -the default branch when you clone the git repository. - -Additionally, there are several other packages that are developed in lockstep -with the CLI. This includes: - -* `botocore `__ -* `jmespath `__ - -If you just want to install a snapshot of the latest development version of -the CLI, you can use the ``requirements.txt`` file included in this repo. -This file points to the development version of the above packages:: - - cd - pip install -r requirements.txt - pip install -e . - -However, to keep up to date, you will continually have to run the -``pip install -r requirements.txt`` file to pull in the latest changes -from the develop branches of botocore, jmespath, etc. - -You can optionally clone each of those repositories and run "pip install -e ." -for each repository:: - - git clone && cd jmespath/ - pip install -e . && cd .. - git clone && cd botocore/ - pip install -e . && cd .. - git clone && cd aws-cli/ - pip install -e . - - ------------- -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 `aws-cli `__ -* Come join the AWS CLI 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 `__ - - - -.. _`Amazon Web Services Security Bulletins website`: https://aws.amazon.com/security/security-bulletins -.. _pip: http://www.pip-installer.org/en/latest/ -.. _`download the tarball`: https://pypi.org/project/awscli/ - - diff --git a/bin/awscli-1.16.71.dist-info/RECORD b/bin/awscli-1.16.71.dist-info/RECORD deleted file mode 100644 index 2fcc33be..00000000 --- a/bin/awscli-1.16.71.dist-info/RECORD +++ /dev/null @@ -1,1945 +0,0 @@ -awscli/help.py,sha256=QbMnlo1HVtO0pgXQEY3d_zpy1OxpNySZFzPw0Cf_7pM,13605 -awscli/text.py,sha256=9pgaZcnPEixyw_C4h5vIgQQBQ1SqtDXPpqVGDRoubVM,4284 -awscli/argparser.py,sha256=A0r_ZBuHNsHV5MSF1PgoRBeSnZyBusl5QV5tkJB5dVQ,7299 -awscli/shorthand.py,sha256=_MY7MR_SFVM-j183qRRZ2eEyCgC9wWvbmaOeocmkllY,14674 -awscli/clidocs.py,sha256=nxC-n8AgIm0gQ1y-YplAQzVeauyJvgawjnax9bO4iwM,27221 -awscli/table.py,sha256=J9G4GlWiubVBzLh-jVFnX3jXUwX50PexAnoc0b3U9u8,15327 -awscli/testutils.py,sha256=Fh-U8qAYwCooI1FsMLk3dFNZFhjlP9XKcA0yB8i1YNw,33338 -awscli/plugin.py,sha256=B3wgRerhgFK1v-QQeASYv2VNLSa9oMuD4X_hcLSescI,2265 -awscli/completer.py,sha256=P7Gq8dlsvdQH2IXx4QWjBils3Q_5NDDHu-hUcOj0mlU,5875 -awscli/paramfile.py,sha256=lPdVmy2O1-er7lZVQCVvpvJCcjkBVsJzjG37XGnbTHY,9450 -awscli/schema.py,sha256=I5b6SqddJPuPIAv8i_hcRHkUigUZj7w7ompC1QuUKw8,6396 -awscli/argprocess.py,sha256=XHnBLBAUtxr7M4jGCxODZXTRcmBsLROjO7OVs6mQk2s,20698 -awscli/arguments.py,sha256=uF9GSCtt_5diupNvXyHAkvIoAEh6EgSk9t58nGj7_nw,18818 -awscli/errorhandler.py,sha256=G5cQC5b2OwD40zoOtAYBFri33Y-Ynh3mYgMrJYDVjG4,3027 -awscli/__main__.py,sha256=jmrMqZY0WS5oklkkuLG--Vv34ElVF1qhrXm09X-Q9HE,662 -awscli/utils.py,sha256=Lv4u3P12D7TgQ_ZUOlK_K4pPPFuwiW4SIPHrQzruF94,6296 -awscli/handlers.py,sha256=VjGau3RQb_KU1w1z4GyZKTd3FRJ0wwPIUDdOwf4-YWs,9587 -awscli/commands.py,sha256=jpbD3p-Bz9Tz-hd13uj-uA3afx026iKNOYaDMHmviTA,2106 -awscli/topictags.py,sha256=Vq41pF4sbO_Vo7EkDHlv8dzu-x-pw3e13lQ8CciKp5Y,12651 -awscli/clidriver.py,sha256=NsLGn2SEMHxYyv-sObO30kaN3niVqPXM6QIB5iWZEaI,26384 -awscli/compat.py,sha256=POwJvveh1VKDz5K4s-VEJBElVkKcrHjwPgLfosS6c5A,13647 -awscli/formatter.py,sha256=w0uvlCdN3GnY7i7SwQ5B8mScYyeFk2VkmfQjjqLfBBc,11122 -awscli/__init__.py,sha256=-ihiuaO5L5nrC8Twqp1D33WXSB0NXJos83EmmFOiZiM,1466 -awscli/alias.py,sha256=JnX9GsCEFGqeVWms4oFhoPT5HTAfFhi-wvEjkNxSLf4,11214 -awscli/examples/ec2/describe-instance-attribute.rst,sha256=W5qVSFaWjSvV-ZvbCq2kkIR5lpocaWlDaDSf7dxPRCE,1695 -awscli/examples/ec2/create-vpc-peering-connection.rst,sha256=zmnY1K9psrow60xl_3JwhSVQVk4iKRo5HwyNdeb98b0,1971 -awscli/examples/ec2/associate-route-table.rst,sha256=_22MuIifivsDbqBFUoX6_W_X4yKfmR1yJ4V0Ytuym3E,286 -awscli/examples/ec2/describe-vpc-endpoint-service-configurations.rst,sha256=YpoS45vzKzsi2J-Hj4S7SPTWgDIhyKDjUOrEe1y3mQ8,985 -awscli/examples/ec2/get-launch-template-data.rst,sha256=LMGxTzF5NTC029mBduTzBI7dsRqDbysPtKE4hHE7I6Q,1592 -awscli/examples/ec2/release-hosts.rst,sha256=ryUv_FQrZ1cS8t_iuAEBdiyclNd3HhiLhIji1UqTFLE,376 -awscli/examples/ec2/create-security-group.rst,sha256=qyfXr5MxM1JS9vo8S6qFVAoDiL6TMtuq97-kFwTdaK4,775 -awscli/examples/ec2/create-network-interface.rst,sha256=gVKwC8tb-wRT15PxNgZGlKrXYhvX7xt56MCAX7pfpD0,1138 -awscli/examples/ec2/create-vpc-endpoint-connection-notification.rst,sha256=OZAwrdjIgZYZlEHT29EJu9zD6w6UsVim7R79aIcbys8,921 -awscli/examples/ec2/accept-vpc-peering-connection.rst,sha256=xxOVMKH4TepZErom1jluhbPLew2OQM56VxRlBOpCo14,691 -awscli/examples/ec2/unassign-private-ip-addresses.rst,sha256=fR90dDPeAH-LsVtGIy5SxchuRD2GI9i52nplVOQzYXw,336 -awscli/examples/ec2/attach-network-interface.rst,sha256=Kk3E7xaUPWMCGzaRXdaAM4ZE5NZuB3_MF29lCKalGmA,327 -awscli/examples/ec2/describe-snapshot-attribute.rst,sha256=YdA9nN9FOfAYo2y_PVgDAxyCpyx3S6P1hIuO0-FOMX8,401 -awscli/examples/ec2/describe-subnets.rst,sha256=lAiWqyrAPv1wOMtm2cxOBmS_YF5lmae7DVqsc6zq3SM,1912 -awscli/examples/ec2/modify-identity-id-format.rst,sha256=s47JzAkkgh5g_8fhI9JWrE3TOdyuIVh-gbVGAuhi6ys,1127 -awscli/examples/ec2/describe-internet-gateways.rst,sha256=Ok40R3mk2a1Lzn5wVadHWkPpGji53MIUco9JjMxYau4,1171 -awscli/examples/ec2/terminate-instances.rst,sha256=jwETBBXPTez7jRGxCRQPQ27UmVLT1k8y91F8_QbDVx4,745 -awscli/examples/ec2/reboot-instances.rst,sha256=Pbc59vmCwuLihIhESXpdNPyUkXaCUhVU3q8Uc-uc4Sc,412 -awscli/examples/ec2/restore-address-to-classic.rst,sha256=blW1Pl18eUJShug_0xEkjkhIW3739qq7kZ0Kzc3aduM,282 -awscli/examples/ec2/cancel-bundle-task.rst,sha256=QvvN395ijIqWb-lS_i3BbXutcq7v6FzdUikNGaChLIw,514 -awscli/examples/ec2/create-vpn-connection-route.rst,sha256=pXLb7g0PmxlKkH5qM2PdTqoVhp0OJnLfCquP58__Yts,290 -awscli/examples/ec2/request-spot-instances.rst,sha256=vaeuamSE_vPF4lslzIgMkVPGTMgAOa7gFQ83-NY4dBA,4991 -awscli/examples/ec2/describe-route-tables.rst,sha256=sCFGU79AiRLcUD0FN-Q2iFg1fITAXsdO-gZqsxiB7lE,3349 -awscli/examples/ec2/associate-iam-instance-profile.rst,sha256=Gt5GgQkzluUn3CIW80Dh0T_9IoEQaYo7mr4vIvD8zqA,650 -awscli/examples/ec2/associate-address.rst,sha256=JAoimG31VIZuCQKFQBH0OW936i3NPEPWHp4YOAu7HeM,1014 -awscli/examples/ec2/describe-vpc-endpoints.rst,sha256=xGJXg2tkLi9TSP_GNsT_EXHruCT6mU5OLA4lostZH-k,2553 -awscli/examples/ec2/describe-launch-template-versions.rst,sha256=hwqba9Ri6BVt6SK7kyOoG7QV2w6umM1LawB9a9_fCGY,2809 -awscli/examples/ec2/describe-prefix-lists.rst,sha256=bu5EHyX9JePqXQHlWEMSxtAYM0VwVOItA0ugJJTUgiA,350 -awscli/examples/ec2/delete-launch-template.rst,sha256=es8FVBCFY9mQtXCkOT-ylkIN_u4-CVY12u8G1q34CGM,496 -awscli/examples/ec2/create-vpc.rst,sha256=Bs580pLPU4HXiwIeSOzebaqdjwpS3c8W2jueKhbean4,2582 -awscli/examples/ec2/delete-flow-logs.rst,sha256=n7G9prgb_LjxlYjqOa6afQXkRsAdBneoYSIioYRa1MU,179 -awscli/examples/ec2/modify-instance-attribute.rst,sha256=ufHntvb42QbKE4AlOXo9hx0AaeKeSxfmw5iYDCg-_7w,1476 -awscli/examples/ec2/describe-vpn-connections.rst,sha256=y12_vxkSCq-x05wn98xoT5DAL48nTEbCsNBsHRv7FVk,1629 -awscli/examples/ec2/describe-reserved-instances.rst,sha256=KKT0yB5MF2foYqEmFeCX7ioTXUTNEdanzccGBgg1jpM,2320 -awscli/examples/ec2/create-vpn-connection.rst,sha256=fcy2BGxqkExFOWDdT0gJpb2X_nGsg68xvoLFxmFK5-8,2477 -awscli/examples/ec2/describe-vpc-endpoint-connection-notifications.rst,sha256=jTZgItGiWHc0mZQPT5GrRCJKowkvpLI6-GJrbvp2al4,754 -awscli/examples/ec2/get-password-data.rst,sha256=xSZRwl32mknTv0vXMXn2jPwlcagW0NHNSJNyJ7z2Eq8,979 -awscli/examples/ec2/run-instances.rst,sha256=iuIla79Rxs90kLU_A45oNj8a1CEUNHy_GOOYzP8lpao,12193 -awscli/examples/ec2/assign-private-ip-addresses.rst,sha256=ZXWQesow8d9-JtA6PqxHjcth6jOwdDlnHaX3QyqeVSI,866 -awscli/examples/ec2/disassociate-subnet-cidr-block.rst,sha256=nzJV_o3x8HePpo47hOu9w51zbls8SJZ7iNs6t0i-l1I,539 -awscli/examples/ec2/describe-vpc-classic-link.rst,sha256=jasVu1ItTEKW28mFDp1meDZP7ax-W1EriAvvWHWPxvE,659 -awscli/examples/ec2/describe-instances.rst,sha256=Nso3gNBaipdFgQVZ-rPMWfrsDT_iihVdCileleVyxGM,2003 -awscli/examples/ec2/associate-dhcp-options.rst,sha256=PEbGfnPIaQCJ2a8CSqakqdaaMDTXmOjd838mnSzNB_w,557 -awscli/examples/ec2/detach-internet-gateway.rst,sha256=L39Azv2dXu1sGUvRG9oMH8BKE19O-rOIZqdRUOdeR1Y,277 -awscli/examples/ec2/create-internet-gateway.rst,sha256=hfeM8bAAdi3mtwk41cegC6fLvplcntGf_uxJpB0e0SU,274 -awscli/examples/ec2/describe-vpc-attribute.rst,sha256=vovvcrL97xU2B-HbuxB5E8R9aLVCqlnSOzwUTUkFWGI,1045 -awscli/examples/ec2/delete-vpc-endpoints.rst,sha256=KTrqO3t2HxRPr65MmyDKGgAs3_qshdYMviEdKnUY4gw,373 -awscli/examples/ec2/describe-network-interface-permissions.rst,sha256=cF_aWhNpfcq9F3EkmnyfpwNa3VYQGV9Mg1f2tQ5kQpY,559 -awscli/examples/ec2/modify-vpc-peering-connection-options.rst,sha256=4kidEKaus7MxuVMvazRoM6mBuqL_vVNLxNpwhhHTMLc,1830 -awscli/examples/ec2/reset-image-attribute.rst,sha256=BtZMdZEkYSfPi2rSfxm31HIfRJpfjYa39OFERrsdCP4,319 -awscli/examples/ec2/get-reserved-instances-exchange-quote.rst,sha256=y5yWKp-LZTZ8yNvEmnLgqWtMx8bB5ULI7Gcita65GVY,1633 -awscli/examples/ec2/modify-id-format.rst,sha256=cwSYVDQkSqYKvJtlQ_jFWgFLmFGJCxdo9OnEMGKMqhA,763 -awscli/examples/ec2/unmonitor-instances.rst,sha256=bmQC6LCVJiMDfkN7EBmZao0EPPO5RmyZxwAPmXheMek,409 -awscli/examples/ec2/create-instance-export-task.rst,sha256=CBIVQL-kJPdhGfwjTs1VthHLrUoVm31_WKtZrrY8r9s,921 -awscli/examples/ec2/create-network-interface-permission.rst,sha256=-FuTJc8CMY-Xeukw-jKHP1uOFu3OxolVS_b2qX5IkMY,643 -awscli/examples/ec2/describe-id-format.rst,sha256=8X_U__yTBhcqaydANrXbMPEDMUqSxPIpdGOWFJr3imM,3958 -awscli/examples/ec2/enable-vgw-route-propagation.rst,sha256=LriqYxP59fHYzgAH7zEFo0ian2mO627681NcOTva1cU,304 -awscli/examples/ec2/delete-subnet.rst,sha256=jHmFc6IYVp8zSSU7PfOyAk-8PB6a-ccjRfko9Q8vEE0,179 -awscli/examples/ec2/copy-snapshot.rst,sha256=KrIbFZV7eHwQXe9pce4Jf3zEmJR7zrHrUGvsMFHNuAw,462 -awscli/examples/ec2/describe-vpc-endpoint-services.rst,sha256=drXgVqjjEcmJfOXRozE0JJHXTD2q_bGMFsVvEpBvUeI,5619 -awscli/examples/ec2/copy-fpga-image.rst,sha256=6VWbztfLo76g5ueRc84Fc0KvFRM15N-m7SRJMMCGeKQ,347 -awscli/examples/ec2/modify-launch-template.rst,sha256=AXynLuzV6YQvDAVGx9Vii6FjlH9VYgffdz4qy15bzE4,570 -awscli/examples/ec2/modify-image-attribute.rst,sha256=A8uGU6ZAmlSuAivMD9EWGEnSnzhrJooufi_jqoix0jU,1048 -awscli/examples/ec2/describe-fpga-images.rst,sha256=iDrtuUNAlR3VBkCKD6iHhZ-Q3FjOlWHextlGs5IfohA,942 -awscli/examples/ec2/describe-key-pairs.rst,sha256=J0S9QG-XaexfcTBwAbTsMduQLO0KBSLNMAFm7RqeeHQ,557 -awscli/examples/ec2/modify-vpc-endpoint-service-configuration.rst,sha256=ROzeShTIsVg_UqgQhtI2eNsRNZGYMo3JFzAikc3msK4,302 -awscli/examples/ec2/cancel-conversion-task.rst,sha256=hB-UlstSTIAHbWGPk1dmWQzhkk2zu80rfPJytPae9Gk,274 -awscli/examples/ec2/describe-egress-only-internet-gateways.rst,sha256=Cd_krARHgrdQ0ZECv9o4ZZOH4VzsM43a_bu9_IoiIFQ,487 -awscli/examples/ec2/create-network-acl.rst,sha256=h-Dve97tMezSR7uzy10z6YlOUbudheHS8WG5xT4L4zo,844 -awscli/examples/ec2/create-dhcp-options.rst,sha256=pppLG4CRIQ5OLlgmK6IEzQCx6GXLIvaXoiXaEhBsrQA,527 -awscli/examples/ec2/describe-image-attribute.rst,sha256=bAoti_hIXe48z_CUSGEDVnk14mrIaKI4k89KuGQufjk,699 -awscli/examples/ec2/describe-reserved-instances-offerings.rst,sha256=e8cmOZ1ViJLMH9EjTgyBBVYX6DfwRwNpLMbJuOxGsAE,3560 -awscli/examples/ec2/describe-flow-logs.rst,sha256=V51jWKMxp-dvzfZQJLLu4gCAxTcGcTXy3cKgBnnpZY8,704 -awscli/examples/ec2/delete-egress-only-internet-gateway.rst,sha256=_275zLi_8DMY5dKRoB_aAzpFqDSQXS8nK3FZCM8lqrY,268 -awscli/examples/ec2/accept-reserved-instances-exchange-quote.rst,sha256=jQeLEd2qwmoO48yIuYVnCHMmkMD-a-OGmnAk4P2VcqQ,416 -awscli/examples/ec2/accept-vpc-endpoint-connections.rst,sha256=WfmQJblgsn21J_XdCYN0s1cp6XQ_77AIJKUWGAvRVIM,334 -awscli/examples/ec2/describe-stale-security-groups.rst,sha256=VFwTx8rd-6nxBQde2sWw9nfPWwzGd_Y0UstP6jE-lS0,2089 -awscli/examples/ec2/disable-vpc-classic-link.rst,sha256=t0H7-vL8zt8-ygmJZlHLwS90D95VMlRLZAuc3RVLSOk,195 -awscli/examples/ec2/create-placement-group.rst,sha256=2XN1Fkq6gYJhkJ1RWCIGNaATUzZYWn6oAC5PjI6RC3U,193 -awscli/examples/ec2/detach-vpn-gateway.rst,sha256=ZCH4s9yQqqXuENjaznDQDLtZMj21jMk-YQPjygQ9RTw,280 -awscli/examples/ec2/stop-instances.rst,sha256=VFqQXF-bGs3Bi6dNQe52N6TASY90-QoewnDoMkKyhOg,775 -awscli/examples/ec2/create-default-vpc.rst,sha256=ijgtT8tHf2YtjBc9QcAH3GPbJ9r2sg_9CqXIY0gSxiw,417 -awscli/examples/ec2/purchase-scheduled-instances.rst,sha256=6NomZ6oUgREOx4Y-YWcAzrJP1VN8tpfST8Jp9JbywRc,1289 -awscli/examples/ec2/deregister-image.rst,sha256=4hCEoJ7PKxmpTUyvcgVXPG8tHH9p-of_CmSa4GUzP2s,181 -awscli/examples/ec2/describe-availability-zones.rst,sha256=alvVBoVKfUAAMJ3PORwbFioVUYMEw_hJjhvYOunOz8A,802 -awscli/examples/ec2/modify-vpc-endpoint-service-permissions.rst,sha256=lIA-w93BY_bDgd4QPQFRNvaKLqfiiDhuLU8fqRmHzyw,625 -awscli/examples/ec2/revoke-security-group-ingress.rst,sha256=FZilUqh2GNHH7Q2E56Ol-MhguAR9Xq9rAhisNVos3Bs,1044 -awscli/examples/ec2/create-vpn-gateway.rst,sha256=dprktkRmpQmK_2kzYglVtm16VSvZOSnlAsSx2ZIa8bw,868 -awscli/examples/ec2/start-instances.rst,sha256=JF9ORHlvG3KCtQlJZ7ogeaEa4Ulpak2w5VG4JvjC1hk,776 -awscli/examples/ec2/describe-regions.rst,sha256=ylaDr8mzZzA2B-WjHTLzS21g2d0N8IUMIt85adJeNuk,1870 -awscli/examples/ec2/describe-volume-attribute.rst,sha256=kGOIOw7SKa0NAJr3eORfZLgsRXcxXlkNWW6GZj0_1N4,383 -awscli/examples/ec2/describe-spot-price-history.rst,sha256=WJrjr0KNxDHoNzVGOwuvzV5ccpjDhGv5e-dcwkwrCjE,2121 -awscli/examples/ec2/create-key-pair.rst,sha256=FBy6rOueSKi0LMmGjMjz37lx1adVquR0pcRxNG6ptCA,435 -awscli/examples/ec2/modify-vpc-endpoint-connection-notification.rst,sha256=4krwxgmitml7uARdLN9hlVbFy0Jtcs9r5tT8s7Ifrt4,407 -awscli/examples/ec2/delete-vpc-peering-connection.rst,sha256=1zEmNXkvxe5OYsjOV5GtMwpxdPp4o34cQ8Byjh-2rRs,232 -awscli/examples/ec2/revoke-security-group-egress.rst,sha256=pRtpNJ7qN0H2DGKpCrGy2GOKV9AEZ4CgQm8fI50OAeA,760 -awscli/examples/ec2/modify-volume-attribute.rst,sha256=k8WGx_Xxwjw1AfRYYc-kdzNYddz-lMUjkAC7wQSw7Bk,293 -awscli/examples/ec2/modify-vpc-attribute.rst,sha256=_UB1hwJy9jpdtSF4xiQeMv3pBABnlxcH1oWfz-oRN88,930 -awscli/examples/ec2/detach-classic-link-vpc.rst,sha256=NWI4bA-pKbmgwF0HdsOC-Yw_oKtMRlpitP2Z7WUqZnA,271 -awscli/examples/ec2/describe-vpcs.rst,sha256=0zbci0IMuH7dlzLcNd88TPRY3zxp4OkzXveiF8Rt57Y,3303 -awscli/examples/ec2/enable-vpc-classic-link.rst,sha256=Mks7NgPK9F_PiwouIIglHe7V-OZbUVprG43sH8AjmlY,192 -awscli/examples/ec2/report-instance-status.rst,sha256=LEVptv5-OZBwZwUt9VDeVF-UexDNNynm2qygpUwbn8g,243 -awscli/examples/ec2/modify-network-interface-attribute.rst,sha256=cuAJrJbSXksXISHWL85GZ4hfM8CrrxHhJ51Px8iReuk,1181 -awscli/examples/ec2/run-scheduled-instances.rst,sha256=yJs3HHpLhGnrmJma74ArQD1DBwpBjdFo15D4PH-7SIE,1387 -awscli/examples/ec2/describe-spot-fleet-requests.rst,sha256=zwF5gXLTnP62E1SgSRodtanmU7E0NghdjF9m85Z81Jo,4931 -awscli/examples/ec2/create-default-subnet.rst,sha256=9ebTG1N0KHqGmHnmHtricib416iHANclxTn-V1C1IwM,620 -awscli/examples/ec2/create-vpc-endpoint-service-configuration.rst,sha256=uBQQmV8a_YwFgEmq9CyV5KFfcQxeuMvb-OF6JFvudUE,1181 -awscli/examples/ec2/describe-images.rst,sha256=KnhcZkh9uIKDl50JF7mRL8aB5w_UpX8QmqXOSCY-OJY,1866 -awscli/examples/ec2/create-vpc-endpoint.rst,sha256=h8BzXFX09Ad8LkLfqKjuzRXPjmeVW7YiXR7-i-F8FPw,2766 -awscli/examples/ec2/delete-vpc.rst,sha256=8yXUF3iDD6rp2ZuGlPwpM-WIfUvDZKDNswwaVyWLzZE,164 -awscli/examples/ec2/describe-tags.rst,sha256=WKPudFukDP_WnARGZRCMgBFxxGjJo8OAcFKk4JJGS7g,3934 -awscli/examples/ec2/describe-hosts.rst,sha256=xL6cVcGiNQ-adp7MYdRqrkrSxhQlxr4o9P9e1yl_UUU,1445 -awscli/examples/ec2/attach-vpn-gateway.rst,sha256=JtrIXoUV9Gr7xnb6XH2n_jdfLuv_eDMAGa7aJ9dTnTg,346 -awscli/examples/ec2/create-fpga-image.rst,sha256=uEQjFlNi33RlbVUiqYhpQbsHS91NbUmWehwft3E6y74,451 -awscli/examples/ec2/confirm-product-instance.rst,sha256=c8rWGguZrdYdrXMBDVeLQA7Fn0dwTLwKyTGELNwZy2o,292 -awscli/examples/ec2/describe-placement-groups.rst,sha256=TDhh4TRCZPiSY_Y1IUVyUE7z1rpwT6NhbelybGMVUYk,354 -awscli/examples/ec2/attach-classic-link-vpc.rst,sha256=E_IcPkLGpxMyoxgb6KUI9JUuf3tYaolBcdBIlvx2z3w,328 -awscli/examples/ec2/create-snapshot.rst,sha256=KSeCenj99t-Jvo1XfJag_RSC8-MOjXa_tVFBGNmAz4o,1532 -awscli/examples/ec2/register-image.rst,sha256=CFCECcfJ-WVBWRm_zheBXmbZM3-VnNhJbRxigYnDz58,999 -awscli/examples/ec2/request-spot-fleet.rst,sha256=qdTPI5-ZuMq7LeRfCCX4NfEE1xdm7452o6JWmNXRUFQ,5123 -awscli/examples/ec2/disable-vgw-route-propagation.rst,sha256=rRlVd84tTWvwrfUvviH-RpJeY75B-mUdD2yR2kZb1go,311 -awscli/examples/ec2/describe-instance-status.rst,sha256=ddNqW0jA2ghQngUcXSPhnJ9uIr1ffxdn4Se2fAlZqsY,1042 -awscli/examples/ec2/create-network-acl-entry.rst,sha256=V3YSdAoKdRAJUG2yZWGC1ou3c266WO2xaDjbgwfsI2Y,778 -awscli/examples/ec2/enable-volume-io.rst,sha256=v_jnTTryedmHVu29iHB3FERKekPfskgfr_Y2EBx8ssg,206 -awscli/examples/ec2/describe-spot-datafeed-subscription.rst,sha256=DWPwvWWKzgUochWJicvPymgsUz-moZsn1S7mkZU_JQk,385 -awscli/examples/ec2/reset-snapshot-attribute.rst,sha256=0sxK3kVDU_sMrYBJqXpLHbV-fOn3wSb8oQiOQddlyhA,294 -awscli/examples/ec2/create-nat-gateway.rst,sha256=w7QIMXac9yurxf3DMIqFUndtbO6ij6oDHy66QezaSXw,645 -awscli/examples/ec2/cancel-export-task.rst,sha256=GfbCGO2928mGOVOa0YC1Qg7PekuFa_HRfiYG3x1mS5g,240 -awscli/examples/ec2/describe-scheduled-instance-availability.rst,sha256=IG_fo6b1XNoF141Fu7rPfKhbiucDG_Wycddekt9cVmw,1422 -awscli/examples/ec2/create-launch-template-version.rst,sha256=PNd1z4kVrjNcSom-cbDX_X_HcoyAyHWvVjHSqSeTFIc,1273 -awscli/examples/ec2/replace-route.rst,sha256=zLojlhga9XC_azv7HpBSkV5aqYlGKbxzR164Ny-f5R4,377 -awscli/examples/ec2/create-egress-only-internet-gateway.rst,sha256=dXSONRSikexgWKJHsDfcvYdI9j6jJpuIMB-r9eIPAl8,469 -awscli/examples/ec2/describe-vpc-classic-link-dns-support.rst,sha256=65FNoIerJVGC9hlw-7u_Iltb1PTEUCnt_L9ZHGih9TM,416 -awscli/examples/ec2/disassociate-iam-instance-profile.rst,sha256=MM7VPeHMfdwl2_v-q115FE89B1hr_fvfA7-SMqZkDKc,614 -awscli/examples/ec2/describe-network-interfaces.rst,sha256=WN3J3I6t_kcTmlDQV6kCUkMnoMsZhB9_Pk-wn-6SA4I,5295 -awscli/examples/ec2/delete-network-interface-permission.rst,sha256=XKDm5nriWvJqSmjl8v2-mMHYRnQ6-98YiR4cwTBPtzw,267 -awscli/examples/ec2/authorize-security-group-ingress.rst,sha256=s0yN_1Z2Xr5m-naX1H1vtQDWkhcPobVoSjvhoOMyJMg,4921 -awscli/examples/ec2/describe-nat-gateways.rst,sha256=ih6HyEaoLvQqES11oWtvsGhnamnNMDHUfkSXW6sjpB8,1398 -awscli/examples/ec2/delete-network-interface.rst,sha256=84ZVo2Ct6jdMcOSEo12inf51rYqDsdgvUVf2GXzautk,220 -awscli/examples/ec2/describe-network-acls.rst,sha256=jsqxRfyd4gv7rtUL3LSAqNq7otOIaIKaP99r6xzi3Ok,5592 -awscli/examples/ec2/describe-host-reservation-offerings.rst,sha256=CNgKJElbijOiUSPYUkaFqb-90jNtpNpdzRA6xU0ghm0,1908 -awscli/examples/ec2/describe-vpn-gateways.rst,sha256=VAgjYy7cE2rduig3fWFs8neFLTsjcVldmSANJXOmQg8,834 -awscli/examples/ec2/describe-classic-link-instances.rst,sha256=IJh5-bLWJaCAbIDMxm8ZhPyIvMSamZNctjY4TIpZ82c,1248 -awscli/examples/ec2/delete-vpn-connection.rst,sha256=RoVxpq9y4eyUEP45sLmcLDrAhKFlB7MDxyaMiR06nGU,208 -awscli/examples/ec2/disassociate-route-table.rst,sha256=lcdP2ipfhV6iXtHRaSv5IkDKzl6y8T30Lo40n3P47TM,245 -awscli/examples/ec2/authorize-security-group-egress.rst,sha256=z8qeE-wOxgcgXW4RzSz0aBtJdsfPYQtecTVTdCI1TSY,1065 -awscli/examples/ec2/describe-customer-gateways.rst,sha256=ZcQEG2DM-jJi_HEr0hMSI5Kfi9XT1ZKLClz3WaxnLuo,1090 -awscli/examples/ec2/describe-aggregate-id-format.rst,sha256=kzvt3iu9UOzAWqZV3Llb7ph7zMIwE-TN8R3IeiZ_n3s,4735 -awscli/examples/ec2/describe-security-group-references.rst,sha256=JG7wqFgvRJ9Qsr5coc8Laa3ebM2h79KmN7y1Q_aXJHk,543 -awscli/examples/ec2/move-address-to-vpc.rst,sha256=Tod51vcaNKM29SZHWfbSATb5wswRMhxATaui1TMXkBE,225 -awscli/examples/ec2/describe-volumes.rst,sha256=F7HmRMG2lmz1X2H4E36Bis5xhpCz2-VssQRQrFcGyyE,4151 -awscli/examples/ec2/cancel-spot-fleet-requests.rst,sha256=LkAA04g2jxI2mtRoEQgQ0x0TQe5MASM0rx9cVI0b950,1140 -awscli/examples/ec2/create-launch-template.rst,sha256=x7cwv_1rUq0NEqo4FIPmKbXRH0zL6RpMPnVOWsiMkXM,1024 -awscli/examples/ec2/delete-network-acl.rst,sha256=xKli2R8P8c1xIXpo8WRQYaI0GmzcdrjN8igAdFY8TZs,196 -awscli/examples/ec2/describe-export-tasks.rst,sha256=U43PdOMBbA32nXIf10ex5bkili8yRDJ03cswap3Qlog,807 -awscli/examples/ec2/reset-fpga-image-attribute.rst,sha256=IqNNnIiG0o5slFxiZ9JEr1nKBz9oniWIrwetGAJ7s2c,269 -awscli/examples/ec2/describe-host-reservations.rst,sha256=itZWs8bclwrIBHsa-Wty-_Iejz79xkiIo_steZ_xDdw,780 -awscli/examples/ec2/describe-spot-fleet-request-history.rst,sha256=AuVnB7axgnOnVdA_rHsyRWKpQYIFNVGRuPjO2TOc44w,1698 -awscli/examples/ec2/modify-spot-fleet-request.rst,sha256=cVf5fcmsRCVnfImiOd83gorNb5eCIxz17LS1bl5taDI,663 -awscli/examples/ec2/replace-iam-instance-profile.rst,sha256=_AFBVbVfTV0UBNNQj8a1g4hTvL-sa3D1ZPrmEcsXMnQ,723 -awscli/examples/ec2/delete-tags.rst,sha256=onWVvxC_63M_1h8fSt1u2BEYcya9zpQkJErF5UFLMcI,1226 -awscli/examples/ec2/delete-route.rst,sha256=AN6jjPR36nC19CbdHyDggPL7v-CCGGi8pXgFYuvQFfc,244 -awscli/examples/ec2/purchase-reserved-instances-offering.rst,sha256=I6JA1jLBuSHJ_GfTLGIxf6TbNTbJdPKPXcdZSWdRnts,426 -awscli/examples/ec2/create-route.rst,sha256=-tJeeI5YPJWHZyKbCuRzUF5_texY9TUzlWlv-nNkCko,1142 -awscli/examples/ec2/modify-vpc-endpoint.rst,sha256=rCKmephPWndudQLHk4rpVoX-JWmZvMMip1_CGbb6FNo,664 -awscli/examples/ec2/replace-network-acl-association.rst,sha256=qhoKdDDMbVkrkbXqMnsKRGMD3BXBxFPCYunBK_u14nE,349 -awscli/examples/ec2/enable-vpc-classic-link-dns-support.rst,sha256=ae2EdkjPaIquCtTVMY8VHbuUvQXZLCUcQywX8RLNlsU,233 -awscli/examples/ec2/describe-spot-fleet-instances.rst,sha256=NrJhurW17PYaKPlCOHhLtyQ1rLag8KVrbEn37qTrJcs,565 -awscli/examples/ec2/disassociate-vpc-cidr-block.rst,sha256=qLOXUlHVf0ctx8R9LDCvkFySPyNYdv_MA1rZ1fUwakk,972 -awscli/examples/ec2/describe-fpga-image-attribute.rst,sha256=mLEb1pKUwUv1GbXLhs4KcCieVikc4ks6ZQU3JoRxqbc,450 -awscli/examples/ec2/update-security-group-rule-descriptions-egress.rst,sha256=t4XaVTg28ZcvFTvXuPV9xi_qmeRn99YhfyYPjhQtEWQ,622 -awscli/examples/ec2/create-subnet.rst,sha256=0NrM7b8G2QziLu98YybQAqqI14U8fxwFkhmSQ_9pDzk,1781 -awscli/examples/ec2/cancel-spot-instance-requests.rst,sha256=W0bot8zzxHeC6GXa5AG1CWOeRDqMm4szAHWpL6uhtFo,368 -awscli/examples/ec2/replace-route-table-association.rst,sha256=J2yP1Foeak8CIq3nlniIVbl0Gxu64buLtOG_GVrEYcQ,349 -awscli/examples/ec2/describe-principal-id-format.rst,sha256=4-0W19_Pgjo5tYbYqBH7YeSTv7fWwFNyLNrv4Fg-7d0,11468 -awscli/examples/ec2/update-security-group-rule-descriptions-ingress.rst,sha256=vhfdlizu_WQ75Gg-bWq2GJA5AIldpRWS6JSMlmN7iRk,611 -awscli/examples/ec2/describe-vpc-endpoint-service-permissions.rst,sha256=_LHvJ-usfylcmxlyTyLREIBomh6N-LZt3_rfHJnuF54,393 -awscli/examples/ec2/describe-reserved-instances-modifications.rst,sha256=4DE8yUrHWXFTY55vTupjFH-TvSWKicPIpoF4DlNWYUI,1658 -awscli/examples/ec2/delete-vpc-endpoint-connection-notifications.rst,sha256=Z7DF1wf-ysibep7qKd2BijlYL_4bysD1TrqDWh2fZFg,285 -awscli/examples/ec2/allocate-hosts.rst,sha256=xyEB5xutAMY8PipcLs3FxRzwzC53mOxvh8pOIGf1mU8,379 -awscli/examples/ec2/delete-snapshot.rst,sha256=qTVFQxO9aOSwtm5hyWqsNv4oIT_BG7EHwx66iwG0Jy0,241 -awscli/examples/ec2/describe-security-groups.rst,sha256=hghpHzy0M6Xj9zGFsdQ1pz5vj0cMZU-ICSymbaOG6p0,4853 -awscli/examples/ec2/describe-launch-templates.rst,sha256=N56scrFTXF7S-ZkiHqHKj4pkYVI4q4qboNKaO0hhZdY,1524 -awscli/examples/ec2/delete-nat-gateway.rst,sha256=bpVFPf7FA085SLA0hDkBwQywTActlvVxt-faCw8bhgw,231 -awscli/examples/ec2/describe-spot-instance-requests.rst,sha256=NGyT6f3EQd6Y0F--3cownot_tOPvibIJ4Srq4K8WAmY,2460 -awscli/examples/ec2/create-flow-logs.rst,sha256=sB6kB4w1_FNTcJJotmFFBQtcxJqUa4bYI787feehdn8,662 -awscli/examples/ec2/describe-vpc-peering-connections.rst,sha256=-Unevuq6PNBdSeh3C6k6Sz3GOhkpCTAGf0M3yoCr4hA,2802 -awscli/examples/ec2/delete-dhcp-options.rst,sha256=0emiTfT9kZFQS_OjXzmuI1gJK0b-Iv5X_8w9SGGK42c,209 -awscli/examples/ec2/delete-volume.rst,sha256=K7fS3x6YWOwxis2EDVZ4Sk7FJaC6eBS4j11KQ_OE8lo,240 -awscli/examples/ec2/delete-network-acl-entry.rst,sha256=45PQI6DOKymu6SmfBz1HtfHmIdZVCNV6tc4atcbocCo,265 -awscli/examples/ec2/delete-placement-group.rst,sha256=KoaIBaRNvu5jNtH5Hx5cfKTOIM_Srbjg8lhTPHAmw4o,162 -awscli/examples/ec2/purchase-host-reservation.rst,sha256=7RonPkldMb-_qEVPJkx6WDSsvBUc3w_rYFP7AHZ1XDQ,745 -awscli/examples/ec2/delete-internet-gateway.rst,sha256=Ipsvfpa9odexwfyxjIE6ZfKm2_WOvrRkhAPMxhMx8lE,217 -awscli/examples/ec2/modify-reserved-instances.rst,sha256=KcmvFeolYkojTArA0XS1CY6CbHPM8Ynpa-zj9aR3KsU,2046 -awscli/examples/ec2/copy-image.rst,sha256=mHqpuafaJPVnpl_R8OXLt7UgDDMGUMQeQRwvw2icsiw,323 -awscli/examples/ec2/describe-iam-instance-profile-associations.rst,sha256=hOnxUMNkHjUXZ77DxD3DluAPWMO9vBAVabFL6tJ0GRE,934 -awscli/examples/ec2/create-customer-gateway.rst,sha256=zrVVFueM5PBjW8vJRdHH7PeN1YuqpJHIskANI5Rrf_I,455 -awscli/examples/ec2/disassociate-address.rst,sha256=rVd_zoqZzbms01Lc0Dzbbye22sVkMs9etb9AndF0iNE,515 -awscli/examples/ec2/modify-hosts.rst,sha256=xL6cVcGiNQ-adp7MYdRqrkrSxhQlxr4o9P9e1yl_UUU,1445 -awscli/examples/ec2/describe-conversion-tasks.rst,sha256=Yfi5u99RRAF6rg0eKhmWrsasIYQElXxGz7d_wxIvmPk,1394 -awscli/examples/ec2/create-route-table.rst,sha256=fpq_DD4aVF8xCAzo2xfvw-wL7L26WGPvQ2hNxIGXojc,561 -awscli/examples/ec2/get-host-reservation-purchase-preview.rst,sha256=4-7ZuU9wLQ-S6oHXqnA203WkVIt9d-D4nSSkhG59JZ4,732 -awscli/examples/ec2/get-console-output.rst,sha256=lncdbh4w4Ky7Gwwv5pH_1YOFLOis4U79HgxgP89Eglk,1129 -awscli/examples/ec2/delete-fpga-image.rst,sha256=vHez2jE3614rK3lFTOsG3fZ_GpWWBu0JmeN7gyQ2Lq8,192 -awscli/examples/ec2/delete-security-group.rst,sha256=JNRKxy5JLphdpa6c5p7OhAj1mk1S2Z1MCSXYEar9vIU,723 -awscli/examples/ec2/describe-account-attributes.rst,sha256=FLUxOsd0neh7HuoED_EMxwW_D7KRkSlXAwPENooeP3Q,2187 -awscli/examples/ec2/delete-launch-template-versions.rst,sha256=v4yMv7OPVvxG3yPtEEmiHCgx_kDaN6zkn92MpdwGXj0,499 -awscli/examples/ec2/allocate-address.rst,sha256=Hayz1q8sFWiEwAgHij7mmx191oOynjMIBmNHevv5RbM,560 -awscli/examples/ec2/detach-volume.rst,sha256=SZsfhXFvWUEY_jywWZgC3Pv6lxpfr0BtBGFrmK5xMI8,431 -awscli/examples/ec2/assign-ipv6-addresses.rst,sha256=xf-dNqwP2dm6pBngss7Tt6FuvmnLIEplWIR0-nyVNa0,1102 -awscli/examples/ec2/reject-vpc-endpoint-connections.rst,sha256=DbjfMeYIeizS86ZpzqpXMkrF0ETQTVyZDjBMZmHq0fA,334 -awscli/examples/ec2/bundle-instance.rst,sha256=tOaXA4H6nENOgvdM5azHE3P6yXuTLrgYdOCLkusWY1k,914 -awscli/examples/ec2/monitor-instances.rst,sha256=kkCmECudndm98dBE0ul4Un2ozE1rMKjJJ8iHr14GhG8,403 -awscli/examples/ec2/describe-vpc-endpoint-connections.rst,sha256=8xFQG0f06M7AQ1Zd7hIGsj_Kv47WHmo0Rdqrb8Kjkd0,670 -awscli/examples/ec2/import-key-pair.rst,sha256=3FJouHuw2lxD0h9wTQMtr764nHNFoMGshoRNLK8UjMc,739 -awscli/examples/ec2/attach-volume.rst,sha256=UXe9OqCeAdsE63jhprEnUAdjzEYNSz5vhitzgVeYMXc,498 -awscli/examples/ec2/delete-spot-datafeed-subscription.rst,sha256=eVQmS9S4BsNzszCZm5e33grVUsr_4Dn4TQKOPIaNTfo,234 -awscli/examples/ec2/reject-vpc-peering-connection.rst,sha256=JQFVvpwvGkSQDeW-DXafkKqgs9-MXgXVZQ9CcKoyOAI,239 -awscli/examples/ec2/describe-snapshots.rst,sha256=0O8_fTykQ0p21RbbsFlMbWfOvpvL_Ro5Du8bOb7uNlA,1821 -awscli/examples/ec2/delete-vpn-connection-route.rst,sha256=caHZRkfAiOgiNuEd9X5coIn1_3lKvOozcAup0OXVHY8,304 -awscli/examples/ec2/delete-key-pair.rst,sha256=LPJemAMvrhF0ziEcwtXM_rAltQ4RX8ovxYUxAb-eOpI,377 -awscli/examples/ec2/delete-customer-gateway.rst,sha256=1XjNv86xBWT4QyQFitsO4a5rl5o0V1BxZKM0pcg-g4M,216 -awscli/examples/ec2/create-image.rst,sha256=6UCb7r3Gy1XbLfX4QJFDHFVPs8SVBKDg4NTxPLETNIw,1318 -awscli/examples/ec2/delete-vpn-gateway.rst,sha256=5wchv0mIfzFATToGwBFEqmCzrz7JDRNnjZzirmRlTFU,220 -awscli/examples/ec2/modify-snapshot-attribute.rst,sha256=on_lOkEhOSUfU7Cy-s8dCSOF5M6BDe8W-QezvWAlAWo,655 -awscli/examples/ec2/describe-dhcp-options.rst,sha256=YETjjQrNMzjA6VrlEv7fqx7hTqi-1BgGrWGDJDRa318,856 -awscli/examples/ec2/create-tags.rst,sha256=5G5dmH-voJYr2S_npJAwhKIbnfDLdr7ZVfCmp4Ff3Ms,1708 -awscli/examples/ec2/associate-subnet-cidr-block.rst,sha256=poJlw3xwU6-djpycsoFoZQ4Z5XOGhmmnDJL8aXEWYzM,521 -awscli/examples/ec2/delete-route-table.rst,sha256=wvBeCZoJmbcFYWC-76wdAuo-f28Di0CQG-6sFAwEKu0,196 -awscli/examples/ec2/describe-moving-addresses.rst,sha256=wOS9llcj-ocuBpA3KbQkhFSnIUMsLB6gGasELtUxn0g,469 -awscli/examples/ec2/describe-network-interface-attribute.rst,sha256=fpRuxLZfDXWIyjZ1_s43N7yWnU4Oz44uSpRX-6L0Rv4,1926 -awscli/examples/ec2/describe-scheduled-instances.rst,sha256=nlb9pjmm_jZvHfv7LaMHr35j11YxvBR_82zHR0Q8tms,1282 -awscli/examples/ec2/modify-instance-placement.rst,sha256=89adof0cHab-Od_vs6Tsiu-BZIMenknm-P0mgfYWRCU,332 -awscli/examples/ec2/reset-instance-attribute.rst,sha256=vmmxenRPlWIpxrHvsuRJDHp88K9YDlJTj46URLQGxhA,922 -awscli/examples/ec2/describe-identity-id-format.rst,sha256=D7Q1XZ6p__z_EOZSsZhANBx9ltMB1NHqEhC2Y-1Y0B8,1098 -awscli/examples/ec2/associate-vpc-cidr-block.rst,sha256=VoCCORMzIRrm6Mx40sivWE04AOZOrtizre4vPPM0WWs,913 -awscli/examples/ec2/describe-addresses.rst,sha256=djPq8KmwjnYSKMdgsbNvghWnuVXvVxCzMmMY4UItRGk,3183 -awscli/examples/ec2/describe-instance-credit-specifications.rst,sha256=G439D9TPw0PUzTS9iNaLNrZ3K7_I2tMBdc-KOsQoQeg,421 -awscli/examples/ec2/describe-elastic-gpus.rst,sha256=cB4V_jDr2f2PaNsoLtMOHTeQdeq7w7zwQNEsYyW4lLI,130 -awscli/examples/ec2/detach-network-interface.rst,sha256=lIECBgQE36NmZKhNAmEvsxpC3-kJKDnCigKXanSlFg8,268 -awscli/examples/ec2/release-address.rst,sha256=tvdX28LtoL6lgr-rij_2pIC9RZ3NZ8WqcUYI4nGNBcE,498 -awscli/examples/ec2/replace-network-acl-entry.rst,sha256=3VTR4xlVJeUO4XXMMSldoe446QLWhVeWPltJzs2oM5w,405 -awscli/examples/ec2/attach-internet-gateway.rst,sha256=s42ZxlLN0vRDbmZa_y0yW6o6N00-FEDsVEgrYFa0Wy8,272 -awscli/examples/ec2/unassign-ipv6-addresses.rst,sha256=IuTZDvm_wi73kJZxPFKoMPM5ecXHk5Vne3P6WUojWbU,434 -awscli/examples/ec2/disable-vpc-classic-link-dns-support.rst,sha256=luJKQuZhrE32wQWQG7I3JUbDKZeSF2EbKxIXF7Bm8AE,236 -awscli/examples/ec2/modify-instance-credit-specification.rst,sha256=kufWVR0ByjQZf1FK7IR602OHnNZG-zakwGDYpkYlng0,566 -awscli/examples/ec2/delete-vpc-endpoint-service-configurations.rst,sha256=r5q-0Ufr9LedNJx_vR4jzQdjGsp4P-dvJfowMHYfolY,261 -awscli/examples/ec2/describe-bundle-tasks.rst,sha256=mzu5XjGZLUwU7yCLRruxyQqnWAry2kOygaMBsF2jj7s,564 -awscli/examples/ec2/describe-volume-status.rst,sha256=mU78m5FYab0a-g04LypGQHIftER0ASDSRt4ZQC13D94,1507 -awscli/examples/ec2/modify-vpc-tenancy.rst,sha256=DdS9HOMff_38cbV69Dh4b07jrirpRZdO2Op2nUI172I,237 -awscli/examples/ec2/create-spot-datafeed-subscription.rst,sha256=IL_m7z8DVJ18vNSApTYqTzJJBrBshofC2q9zJETJdpk,413 -awscli/examples/ec2/create-volume.rst,sha256=-ltWuKCb2NkjgY0K6icLytLwTVZGZzJ2sfbW1N1cBYk,1620 -awscli/examples/ec2/modify-fpga-image-attribute.rst,sha256=hZiCGtCKRNeheVoQuYqyiJ6clEkYI-u7DT9SWQNwACw,514 -awscli/examples/ec2/modify-subnet-attribute.rst,sha256=Df6tjMRicTFe8xWyhj7e_-VHWv4B9j-jfXwuDC1wTX0,862 -awscli/examples/codepipeline/disable-stage-transition.rst,sha256=1gk37KMx8ABwOZt44Ork-JECHM04vBY4rCcf-ifr5_g,314 -awscli/examples/codepipeline/list-action-types.rst,sha256=TpU1I_naPosJvb20aGFIiOFheDvK0uJ1m0dO_BnSZQU,2364 -awscli/examples/codepipeline/create-pipeline.rst,sha256=-x5IrSudCG3c347YSlv8tEIIuitgeQ_cUq7WWs7ZBG4,2122 -awscli/examples/codepipeline/create-custom-action-type.rst,sha256=YcSUI7dzpwLncgyNsFuqXkutbJd_ZE5Rbv-TMTkqJOA,1429 -awscli/examples/codepipeline/update-pipeline.rst,sha256=kWhVLEwawtX4VJmU3XKAIRIvXq6HlLb4UNBiVVJ0BvQ,4184 -awscli/examples/codepipeline/get-pipeline-state.rst,sha256=8_TsYPUmNhUWZB6G86S_grKKf1ztVMuSwQtrB2j8ChY,1391 -awscli/examples/codepipeline/delete-pipeline.rst,sha256=1eoGCo67Cg0n1XHOV5JhNfgsNmSRa_6_agT1Dn37GOU,287 -awscli/examples/codepipeline/list-pipelines.rst,sha256=d0eSxYeUSk6Mep5Lwxf15jNJcbR-u23ul-bhA1GjHA0,536 -awscli/examples/codepipeline/enable-stage-transition.rst,sha256=g6aU5XeswimSz9zLHdDqxvh2Qs5Wf4IwNZkPLXIOiWE,311 -awscli/examples/codepipeline/get-pipeline.rst,sha256=ABW7_zbJuTfHW1V6ZOzoS8BXwdCGc9u45cVnoys3ufM,2415 -awscli/examples/codepipeline/acknowledge-job.rst,sha256=moDs7HSWzEf8PWCtsL66Fvq_nsEflhgaeYdNfv-6OKs,425 -awscli/examples/codepipeline/start-pipeline-execution.rst,sha256=o8IGS9hmvdKxKgs4-U52cD6_hGxlryrlFjAmlIG4-VU,326 -awscli/examples/codepipeline/poll-for-jobs.rst,sha256=UEm5_AMWIRZBYnORDmSXA_gUV5qFAGJVSs2sS8gYc20,3246 -awscli/examples/codepipeline/get-job-details.rst,sha256=xxxcuT4KVKkSTAKtBtsxbrgzMVOeyU8zqAyd6NVYGzo,2730 -awscli/examples/codepipeline/delete-custom-action-type.rst,sha256=c4LY6G06uNbNvJcrV9Sz0utRmoY9_MC8gxdKqFjOnFE,609 -awscli/examples/elb/create-load-balancer.rst,sha256=6LBwut2HdG1b3Tr5Pt84JF1WF4HiXP4PHiyay-NplIE,2380 -awscli/examples/elb/describe-load-balancer-policy-types.rst,sha256=U8IjUorFUuu0JoC-htc4P3WnV_5190HwiC-n-32fIao,3454 -awscli/examples/elb/create-load-balancer-policy.rst,sha256=h65Jev4OSM_PaFogwgRj2ySxae65rpGWuBt113gKkBw,2670 -awscli/examples/elb/deregister-instances-from-load-balancer.rst,sha256=7o57G6_4fbnnVt0CggRGGe7D92KqUAnTagsUnKENnGs,460 -awscli/examples/elb/set-load-balancer-listener-ssl-certificate.rst,sha256=ogNf0meKrcr_svbwskbA7HGFZsSeitYD_1X9pedFPDI,365 -awscli/examples/elb/set-load-balancer-policies-for-backend-server.rst,sha256=hDS3ZX-zfsIZpTqa0CnCImxE7qR74Cwj-N6NUfwryww,737 -awscli/examples/elb/add-tags.rst,sha256=tumWzjxibL5ANudJo0c6xMq_Yld5Dz6YzAhFr76G8mc,231 -awscli/examples/elb/apply-security-groups-to-load-balancer.rst,sha256=JcnV3scDfmyG2LHMGlrBe_P_TIL22Jf7Xu4A9rKtQY0,356 -awscli/examples/elb/describe-load-balancer-attributes.rst,sha256=YtE1irg8-5r8FtcUVNlQYCeQYBkBVCMBg6GPQMZKbkU,581 -awscli/examples/elb/disable-availability-zones-for-load-balancer.rst,sha256=GanQKD-kvoPXxZpt7DeN2ilIen4wqcW2q1-ZQeKFfvA,405 -awscli/examples/elb/describe-instance-health.rst,sha256=Ns--NOSxtRTapdp4g4DNGY3LfmUxOHWj4iD3YBVNxoI,1563 -awscli/examples/elb/create-lb-cookie-stickiness-policy.rst,sha256=GhUfA9bqNWiFc8XHav2zGjiztVpccZ7NpnrkwIgFfwE,370 -awscli/examples/elb/set-load-balancer-policies-of-listener.rst,sha256=pl0Kbu1KuXtFsEvfkY0mZwietS5N9WARNNMlfYA_xaA,729 -awscli/examples/elb/describe-tags.rst,sha256=n0Q_0v-g1HFdtI2SiN7p3o4aRrR7-vgYkuytVJULNSM,611 -awscli/examples/elb/configure-health-check.rst,sha256=Oy8X7PxxGyrrfV65oHQRHmQoTl8at9BAQfLZX8slLQM,568 -awscli/examples/elb/describe-load-balancer-policies.rst,sha256=pzV2gRnQGRZp9hjPrk6D6MIQWOnQWfaOigMDMas5vdo,1902 -awscli/examples/elb/detach-load-balancer-from-subnets.rst,sha256=TpvkCEr7js6uGKcngQSDOuNZEpIGUfPK2uZsaVMwpxI,320 -awscli/examples/elb/delete-load-balancer-listeners.rst,sha256=SMsr0yErbmo6SDUR9KX71gyLYpy3LgbbyzKI_uMMTOc,261 -awscli/examples/elb/modify-load-balancer-attributes.rst,sha256=K-NEtS7kDKVGGggbKmbwEbLFkyez4nECttyW0dQLMWI,990 -awscli/examples/elb/delete-load-balancer.rst,sha256=pDRAeViFN326oZUC1T9G8mO1YazjQIyiH78Phj1j78s,166 -awscli/examples/elb/enable-availability-zones-for-load-balancer.rst,sha256=BZBhyA3FQZlqKOAYs8dq9oYq1zy8jCcbL0aaTJebjlE,390 -awscli/examples/elb/create-load-balancer-listeners.rst,sha256=gVo6OHRdlWqRAdLyUuzDlVFTfAwAQhyqW7JDLQvjlqA,649 -awscli/examples/elb/delete-load-balancer-policy.rst,sha256=_uAMhacB60aff4uUUBh5ohK6RFiXwI7MRvEZTEd_OIE,305 -awscli/examples/elb/create-app-cookie-stickiness-policy.rst,sha256=KzuxEKobddj2LgufqQON6sKjGseEbjWbkizIIOV9hMM,349 -awscli/examples/elb/register-instances-with-load-balancer.rst,sha256=HZ4vO6cstkrrYdMAQquo86BbO8QHCSrIaC35pHgOV9o,497 -awscli/examples/elb/attach-load-balancer-to-subnets.rst,sha256=5PZsGyG-Hqx-6Nwq4iE5caGU24qqxzQPVzVNVZxZPeY,371 -awscli/examples/elb/describe-load-balancers.rst,sha256=yMoMz9XCAT-KyLIwpQYpTVxGE7DxcbIEHaYMN8DnUCM,3090 -awscli/examples/elb/remove-tags.rst,sha256=_VehxvV_qNyyKhNEO0rw6TfL_C7pEAy_QVTMXMhNbYk,189 -awscli/examples/datapipeline/list-runs.rst,sha256=Z_iw1AkyWWE8o8XqqkGuOxptOJKDmQdkC-gf2Gc40oI,1630 -awscli/examples/datapipeline/create-pipeline.rst,sha256=WQex-CNgmp47gb9aaVsRPJW8UWRz91Uk-Hc1c0md8Ik,239 -awscli/examples/datapipeline/add-tags.rst,sha256=n8HgfxSCI2lcYRgUFEYDPJyYegR9sUPAFBwxf8a1D_4,667 -awscli/examples/datapipeline/delete-pipeline.rst,sha256=nWdLh0jX1Z7CAs5wjmPrjCcmZzIove8jAM9rITk3k0Q,147 -awscli/examples/datapipeline/list-pipelines.rst,sha256=IcNaXdISjmhUqHe_WSRLx6sIAX7vcRey205hx8ZzaUI,578 -awscli/examples/datapipeline/put-pipeline-definition.rst,sha256=atfjJdiXMyjvftR-fCcrot4z1BfM23_lSZ6CdC-c2TI,386 -awscli/examples/datapipeline/deactivate-pipeline.rst,sha256=tFfzqUOj4PuoS3aO60Cxv6Ztmik4_BJoczmqMGQt6hw,358 -awscli/examples/datapipeline/activate-pipeline.rst,sha256=aQE1IJw83KxodcjOnkGnU_S1dWdNqbAYbE_8auTItNc,352 -awscli/examples/datapipeline/get-pipeline-definition.rst,sha256=HuShLqfn-nPh-jXn0GcjnMLe9tBaM0DMiLZXmXxRfEs,2845 -awscli/examples/datapipeline/describe-pipelines.rst,sha256=IZtIjjhih4HZ0C_fTS2iVy7HwvJim_531374hEvYodc,1570 -awscli/examples/datapipeline/remove-tags.rst,sha256=HSsiNzpEE69_fh52NzeKWL7tnWNmqRO6qK3dVubgFOw,200 -awscli/examples/devicefarm/get-upload.rst,sha256=fPltjkzHu1rfLD1pVvIuYjMCmPb-Fd2YzL8tOwphjIM,1000 -awscli/examples/devicefarm/create-device-pool.rst,sha256=urSPk51MezcFlhtq857jOT3LUQuQ-qqceC9AQoPQcGE,1055 -awscli/examples/devicefarm/create-project.rst,sha256=LjeVOqVd4ozax25s60uvFfsFcHej0lVysbTE1ntdD6E,360 -awscli/examples/devicefarm/create-upload.rst,sha256=ZxY8pT8ezSafaQ5JyM1zVWWtmlwLWfAOFiPU8GvRBVc,1918 -awscli/examples/devicefarm/list-projects.rst,sha256=jUSEfZg17zwozqMgRAxm3rpWctDmHYAd7D3TN7S4uow,570 -awscli/examples/ssm/create-association.rst,sha256=BWX3Sia-tzFUrhAjB1Y1eVJqeYTKc78rFQslc-IySvM,1271 -awscli/examples/ssm/describe-maintenance-window-targets.rst,sha256=xuX80RvG_e1cngQdWWA5lwB_qVjPlt9oNk7ZfazLsMI,1526 -awscli/examples/ssm/list-tags-for-resource.rst,sha256=tltMJnklv705p5H3Bl6-Zh88vWY9_YJk-B_a4QjGeU0,294 -awscli/examples/ssm/describe-effective-instance-associations.rst,sha256=R6X66GOizVXrxNe24IRIC_koDw3hUVK-s4iXEJCVKec,1792 -awscli/examples/ssm/remove-tags-from-resource.rst,sha256=PIi1c9S0SJpyFBzU_hMtYsNHVTCErgvh_mmrfL3i-vs,278 -awscli/examples/ssm/update-document-default-version.rst,sha256=17iO0dABupeXQX5XoD9_qI2SaeWKt93hbY3S-lqt7aE,243 -awscli/examples/ssm/get-inventory-schema.rst,sha256=HK-PWdcZL2-b99KzNf8jrE8TTRNOvyOhNtZ8bnZke4c,1166 -awscli/examples/ssm/describe-instance-associations-status.rst,sha256=Q6GpRasGN2ytIgsD0LBhCzAWgxNmsjwBAOCpygAumXI,575 -awscli/examples/ssm/describe-activations.rst,sha256=AHPqMe8FSpR46aO64lqXmufW1-bRh1QfZxqJGUYEqOQ,564 -awscli/examples/ssm/describe-maintenance-window-execution-tasks.rst,sha256=vZjLH46sokf1HHei07YLpGPLPrArvGSzJeGavMEA828,698 -awscli/examples/ssm/describe-patch-groups.rst,sha256=UpMqJLGlf6MN0SbTSRAqLKpcWy6nboNMOItuLwaDva0,543 -awscli/examples/ssm/modify-document-permission.rst,sha256=h6vlIoWcSFU93BRuSGB3ds6yZYF-Jw4usM1ddYD3lDs,270 -awscli/examples/ssm/start-automation-execution.rst,sha256=gYwF9l7YM1MNF-7PcVMbMh9pE6ahIvlEVutfMwnKpNU,412 -awscli/examples/ssm/get-document.rst,sha256=vrCc-3NUyHtNOBvInQRmnE1g-JqAazeLp2z9L0Y6smA,998 -awscli/examples/ssm/delete-document.rst,sha256=IK0nKGnIhqfJPa5k0QqR_5mrwtvKz-gkQeHzoUP6yyY,159 -awscli/examples/ssm/stop-automation-execution.rst,sha256=nlsANHEqRenn4O_hT4RPcx1_FNTG2k1Fx_pJrmVxYTg,256 -awscli/examples/ssm/delete-activation.rst,sha256=pJkUiZZMVDNdTgm7DXIMNjYDzrcrC_ydtUnxfkB7zQg,204 -awscli/examples/ssm/cancel-command.rst,sha256=OJK7gah04zv4YG1Uz27RJa5a0Lg4jhTUt5SvCZLDq5A,214 -awscli/examples/ssm/describe-parameters.rst,sha256=FlWbcTKx7SfaIIko77dzcIr1KcOGAS5uzTTFIzJjyeY,542 -awscli/examples/ssm/describe-instance-information.rst,sha256=FRbzUrU738-jiNWkACH8qnSw_hrANeAjckbKubx3Owo,1308 -awscli/examples/ssm/update-association.rst,sha256=L0LoFsGbrIxjUuskt91ngLUD40Ohd8NYmevBkKe8igw,953 -awscli/examples/ssm/delete-association.rst,sha256=Dd4RA38GzHsnanSJd2XCUjkk8jF3h9vMNi2cZJDH07Q,252 -awscli/examples/ssm/get-patch-baseline-for-patch-group.rst,sha256=i-bcKjxd5g72fAZucnT0QiZQfgBPtMYveP7lt4FRzC4,289 -awscli/examples/ssm/describe-maintenance-window-execution-task-invocations.rst,sha256=9EfG0OKQV-_KeX2-H0aThray5jGBBFMqB4mOz7aDyXg,973 -awscli/examples/ssm/update-association-status.rst,sha256=N47O4t33jLmv007erjiJ4lJX-ew0tniKywLJmbQOXKk,1287 -awscli/examples/ssm/describe-effective-patches-for-patch-baseline.rst,sha256=bQZj2vLlMo0NVrHb8HqXBRSHVbFWZAQKPThjbgEZnnI,1589 -awscli/examples/ssm/get-inventory.rst,sha256=wTzr471PQztTJWIvnSa90F5xwnQmWxNhMHr8igBJzmo,1159 -awscli/examples/ssm/get-maintenance-window.rst,sha256=nkCMLywSOxllDduEFvuNww4alsag5Fx6au_1DBFlDBc,480 -awscli/examples/ssm/register-default-patch-baseline.rst,sha256=mF2z5jmRI2KYDx-FqzLsoj6hqRVaBVT1rE7v1S_kmps,257 -awscli/examples/ssm/deregister-task-from-maintenance-window.rst,sha256=s5oLUecOYa0OO4cDKNlh7l0hPmT06xxQTn2kZT4bHog,366 -awscli/examples/ssm/get-parameters.rst,sha256=O-T2dWsT8rLcVEeSAY9JWQi-iJV9qZGKF6b5VzG4sXM,656 -awscli/examples/ssm/deregister-patch-baseline-for-patch-group.rst,sha256=RuwvaawinQnQTS-qt1HhWy64-6rM8IXV_SmxvDl-2mE,429 -awscli/examples/ssm/list-commands.rst,sha256=pNlkVe8INJdCtdSDP1kD4WVvyppKzx--Ir7p97i2HHU,1068 -awscli/examples/ssm/describe-maintenance-windows.rst,sha256=8gjWRmWmEoq-HomTNXzFyXlpgyhFZy8rkPlGvCaUvM8,573 -awscli/examples/ssm/describe-maintenance-window-executions.rst,sha256=ldVmpFXUnMQ5WZbMNgiBOkMsTddTvnnqiSEuyXxYSio,1159 -awscli/examples/ssm/update-maintenance-window.rst,sha256=HlK2iB_e6S1kLMYhUZnrKscrJU8yYINpvXXmULP_tTM,755 -awscli/examples/ssm/update-managed-instance-role.rst,sha256=fCmrexTusuh92ZfzjyWXrmE63TNib6RZekX0mvfc66E,259 -awscli/examples/ssm/get-automation-execution.rst,sha256=SWlysu7GJ7OfDmW7haE4vb3EEOiiBzQQh8lMM1tqxRg,2871 -awscli/examples/ssm/describe-instance-patches.rst,sha256=HXTS-pVfdVYtHsW8SlU8m5Ojf7P_uuaqnDgjICO2SQ8,1108 -awscli/examples/ssm/update-patch-baseline.rst,sha256=MFsisxEhtrg0IUyBUsCBE3D57E_S3yw0WLB29usfvpg,1856 -awscli/examples/ssm/describe-available-patches.rst,sha256=4NVLCgO-cbJ-Augp8p1WSxHTnXFiKf9dTDQlczqi9dI,2177 -awscli/examples/ssm/delete-maintenance-window.rst,sha256=RTD7--n7fi9Bzw5o2TqlJNgUD6anXl-0TMvCIDL4HAE,216 -awscli/examples/ssm/get-command-invocation.rst,sha256=x6srNA7GTuZG4higrLkl3baVWAYE8PMOvjHcX0v16So,739 -awscli/examples/ssm/deregister-managed-instance.rst,sha256=-inQ7bNuU9dasitFIBKSkcQS06MrbxX0V7kXp0wWqNo,214 -awscli/examples/ssm/deregister-target-from-maintenance-window.rst,sha256=bLDW46WqG41eTWDTUD4sdjjfGu-Mj6vqfWWtE4WnNrU,380 -awscli/examples/ssm/put-inventory.rst,sha256=c7FoGKf4pIhF_gACMhIXHNE0jghqvBHOvLnTjXsOFY0,396 -awscli/examples/ssm/register-patch-baseline-for-patch-group.rst,sha256=BlcHiN4W7blZSZrpuPTHW2DP6sB1WNexfbmlqZVRVbI,329 -awscli/examples/ssm/describe-instance-patch-states.rst,sha256=OfkQyvWSIT9G8OV3Tow5Xdy6cl7Fv1KUazyTkdkfK5I,1058 -awscli/examples/ssm/describe-maintenance-window-tasks.rst,sha256=9jlGKsrz6D4hyAsUOrNGz_fFm_4n3yGSwHPOG4w6ygM,2069 -awscli/examples/ssm/get-deployable-patch-snapshot-for-instance.rst,sha256=BrQuK-8SwLPXVUzfWAsd6tQwVL2HwUwPTxoBLoOPn8U,1214 -awscli/examples/ssm/describe-patch-group-state.rst,sha256=P5ErJos4ifjnifkYZCx4tJpwr7P7jgOMcz-4eRmBeq0,434 -awscli/examples/ssm/list-documents.rst,sha256=C3m14rCgM7HTYCLLHZSUPSXFfk7RRVY9Sq4d5xZJX_E,606 -awscli/examples/ssm/register-target-with-maintenance-window.rst,sha256=d30tEWhu-Yo4qfsQHjQwgttk6yJyRDTD4kzkbeV4ONU,1161 -awscli/examples/ssm/list-document-versions.rst,sha256=5dq_CfHOJpdijuIvLvzEOOclIb0lIe5pNVMu6Axz0yM,485 -awscli/examples/ssm/describe-patch-baselines.rst,sha256=QqRbb4ar-nVIhASlyVtZpjPWVu6UaW9qFzIBRojWHoc,1359 -awscli/examples/ssm/describe-association.rst,sha256=wR3oY7-9kyo6vZVVRnM5IU8qfxe3RiuDA8XrNojG4To,1098 -awscli/examples/ssm/create-maintenance-window.rst,sha256=sLNMxqgUQBkyaMgFNyciEsJWkGEsxGv-mpJcEeiOwJI,440 -awscli/examples/ssm/create-activation.rst,sha256=7bQ80gtmd_oVLpf7yVyfCJOnJLQ3TuSlu3o5LDH6fX8,325 -awscli/examples/ssm/delete-parameter.rst,sha256=j-oPHabIDMbZ2QiAl9T2JTNZR3VjV1qKD4cy46J3Flc,164 -awscli/examples/ssm/send-command.rst,sha256=LxfTuGewmw1UcfuH3dyxLWISEvp7H5fQi9hBQtyFTEk,1601 -awscli/examples/ssm/create-patch-baseline.rst,sha256=ynWIDNTzwjLWzYq0ebXGg_Nhq8nbPyjy4NpV-7cYY-Q,611 -awscli/examples/ssm/get-maintenance-window-execution-task.rst,sha256=LtVEK2ajpy08SL5luuN7fJ6aEiwUK-gg9oCIJdp9GpE,1070 -awscli/examples/ssm/add-tags-to-resource.rst,sha256=o8ZZguXd_QgBhACvOw28-jyz6NyP_4uGuLt3e8y3RN8,285 -awscli/examples/ssm/create-association-batch.rst,sha256=WVWGZiIxTu72ieOgcGiNJ506vaGPhhFmiR9fdh6LT34,2098 -awscli/examples/ssm/get-parameter-history.rst,sha256=HvPIRyBDQX5EdCKDOYGuw4Q-NlFk_mLijv0D0hS0rSw,441 -awscli/examples/ssm/update-document.rst,sha256=16ozNQXrFS6FJ1U3g_R2LM21J1PQsj3k_B5AEQJrH-A,1131 -awscli/examples/ssm/create-document.rst,sha256=WzUVpFmZNMI2UQWgKx_JmQA0s0da1I2V8TL1wF2GKsc,1327 -awscli/examples/ssm/get-default-patch-baseline.rst,sha256=bbm0dGOdwlo1evguShjhb6Gu0iImcWQ_g0qlDFKB6N8,250 -awscli/examples/ssm/describe-document-permission.rst,sha256=f1J7fc9Ni7JrrFZCCVe-EqaepbdhIiwh3LZMsF72nu8,256 -awscli/examples/ssm/get-maintenance-window-execution.rst,sha256=IRKoVjFqJWoN3kdBAIs5pAYjmpRS6cKn_hd241HeaWk,522 -awscli/examples/ssm/register-task-with-maintenance-window.rst,sha256=NduGoAaWHw3R2llcRxzNfz_t4rXLuCU5ZaiWFUxkWMU,4073 -awscli/examples/ssm/list-command-invocations.rst,sha256=hPCz_nJu9VMNuFv9HZ4t__rofhZNctEIlkeXZeFzi3w,2079 -awscli/examples/ssm/list-inventory-entries.rst,sha256=7iA4lL4ljnWw3FGIE-8Omwi33lTktHUEbdtJzY-N5HA,461 -awscli/examples/ssm/describe-automation-executions.rst,sha256=i2pCSZ1WVzQju7Ro-ScvRolf_K9BqmeI0WZ-9_eNQSs,1055 -awscli/examples/ssm/describe-instance-patch-states-for-patch-group.rst,sha256=pTYwgf3r91j8Yo1ptpDWS3q7u4OdSzAowQXF7AULi-g,1200 -awscli/examples/ssm/list-associations.rst,sha256=SconTRKh8TDkzOwfe-7wSgAM8blrteHrzXa9GWdA31Q,2413 -awscli/examples/ssm/describe-document.rst,sha256=bgWz8_XDqCFpEfi3b0P3sENeRJCNhCj8PlcIEP5fTz0,928 -awscli/examples/ssm/delete-patch-baseline.rst,sha256=MvIC3K38lGW_RVkHsGIMvBJPbKCBlUEQEIw0ZL0O3aY,212 -awscli/examples/ssm/get-patch-baseline.rst,sha256=KwfBX9MV4dgO6nUX7tTlwkVRcKzx8a2frHN7wx4NETI,969 -awscli/examples/ssm/put-parameter.rst,sha256=0fdfBboS9eiSFIB_CNA4gg4y0H9k9XhLXnMTRojSOpY,774 -awscli/examples/configservice/put-config-rule.rst,sha256=SW0w6YjyhcaLFuIl1S5BtwriRaqswQAdG4jp38_dGbY,3279 -awscli/examples/configservice/describe-compliance-by-config-rule.rst,sha256=wxJgtePxq-0kxsjpAMqiFRJArha9NUjxdgkV9mox5hw,1309 -awscli/examples/configservice/describe-configuration-recorder-status.rst,sha256=hi-IBNdLcJFlzsqohZgcCEr8QRC21cjxVzD7z8Ipznc,570 -awscli/examples/configservice/start-config-rules-evaluation.rst,sha256=ODwcxST8jXGbpzeG16cSXfpbOqS1CLHY8gqqCwX3YlM,248 -awscli/examples/configservice/get-status.rst,sha256=2L6w-ji0UI4xH7spxkgC8GsZPoPjUyMfM97IXfI10vU,435 -awscli/examples/configservice/list-discovered-resources.rst,sha256=foyBBxDyMl4jBiOLcOGIN0GSCtIyGMfCpV016KLA6MU,659 -awscli/examples/configservice/start-configuration-recorder.rst,sha256=E_Um8eViJczsqWlB1-V4vnl6WfIxGFgsEd5QjyVxVkE,426 -awscli/examples/configservice/put-configuration-recorder.rst,sha256=YNXUikZer1d-zgUhyACw8VvJq9MN_KJic5ACEnQ9n1M,1719 -awscli/examples/configservice/describe-delivery-channel-status.rst,sha256=FvBKreZEZ6HHucwi59l4wlcSNxNQWvhxj2OCYXg4TOA,925 -awscli/examples/configservice/get-resource-config-history.rst,sha256=EWbN_V-41jV8Akv8v-5lNmefQ5uDnJ4Vwjf0x_r6BaI,278 -awscli/examples/configservice/stop-configuration-recorder.rst,sha256=hEu8n61mmFYzqUhoL-O5aOCRMzEu2UqDXZRqNGKpI8k,426 -awscli/examples/configservice/get-compliance-summary-by-resource-type.rst,sha256=T_hX5TqiX80c7Y6MCphL7HFoYEZ527EQaONXA44LXGE,1912 -awscli/examples/configservice/describe-config-rules.rst,sha256=BZTeKDVJdTg4AT-ZsVed5cuxrGfdo4Qzhb1CBV0Ge-0,1358 -awscli/examples/configservice/subscribe.rst,sha256=Safrx1Xi_KqaX9IO0xM9Zrz2rnyJ2sv5RXguOh__Hr4,1178 -awscli/examples/configservice/delete-evaluation-results.rst,sha256=Kd1P712qYg3rXgbY6ZQkJJN3eINflj93oZpRYlIyEVY,256 -awscli/examples/configservice/describe-compliance-by-resource.rst,sha256=iomh4HcLHmj2JnRjNeiywwCXXL_T3_2srE1YoiR1-Fo,1378 -awscli/examples/configservice/describe-delivery-channels.rst,sha256=SBqQJGKWvXfxx_yDM1nd4M3_hSZrbzQw2e9wgsTN0pU,432 -awscli/examples/configservice/get-compliance-details-by-config-rule.rst,sha256=ps-pbKJUACMcAt0NvcxahDI9nNhufATmiBl4Bk15k-k,2119 -awscli/examples/configservice/describe-configuration-recorders.rst,sha256=bFPT1A0nVcFWR5JtK4LQRpBaKVoJYH4omvIYuukC5CA,605 -awscli/examples/configservice/put-delivery-channel.rst,sha256=aKr_84oFCO1h5CkzXk4yU2dU1b0xsZj0nAgx87zQm9w,2320 -awscli/examples/configservice/get-compliance-summary-by-config-rule.rst,sha256=7_FCAGKZe6CO1rJGPyp4WvqrdjOxnl_Wr8dIgAUNF08,722 -awscli/examples/configservice/delete-config-rule.rst,sha256=L7glYoPaXWXngMGul73An01T9umiqHaNL2dgQYLAlLs,181 -awscli/examples/configservice/delete-delivery-channel.rst,sha256=FSSHMkYxzMSkN1AIGkDy3bKSj_BLVg6j9XNbpajE-04,173 -awscli/examples/configservice/get-compliance-details-by-resource.rst,sha256=0ZbD1Zl7UFo4SY0eOH68Gkl1EvnVrW0G01D93knndQQ,1537 -awscli/examples/configservice/deliver-config-snapshot.rst,sha256=RaDJ_nP9GCIRwcsDdNkmwafuK_JjQKp7UNkWMyxR7GM,336 -awscli/examples/configservice/describe-config-rule-evaluation-status.rst,sha256=O4oQDXvHrXN5CeaWIoJMjxI11-5nhkM_3Hg0if5VG5M,677 -awscli/examples/secretsmanager/untag-resource.rst,sha256=uOUiXQ2OXYZ-QefeopRq1RVCYEi28jTRKIwK47-HVbA,382 -awscli/examples/secretsmanager/rotate-secret.rst,sha256=hMhAtc0O1qRMpsGpGdXTsZrrEsx8_57yMG2rAl-TxMg,1478 -awscli/examples/secretsmanager/update-secret-version-stage.rst,sha256=sP6fHUr5WNUb3WBgn9znmySsO-cOzrC29cwdP_HFwjc,2082 -awscli/examples/secretsmanager/delete-secret.rst,sha256=GZHaXeKDzEBuIvD2CYqsUCZacO5PkEYidrQTTQ00YqE,627 -awscli/examples/secretsmanager/delete-resource-policy.rst,sha256=vE_MFs5cbxXjmqgfS4XsiUFosNq4f1Xic89AZpa_Gu8,667 -awscli/examples/secretsmanager/tag-resource.rst,sha256=PkhlH1W3mJZ7M79cYWgDAnHhZK80H5p8cQtW06UEU_s,383 -awscli/examples/secretsmanager/create-secret.rst,sha256=_w6YL6Nj9TSgxerW1u2gPhToEgO5cJW25DEyfo4vI2c,597 -awscli/examples/secretsmanager/get-random-password.rst,sha256=juEXN8rnbD1tBs2EdwprnWuEU6k2fcZgarPEEg6m99o,457 -awscli/examples/secretsmanager/cancel-rotate-secret.rst,sha256=iZ5Pqx92QW3IUj6-dc7H6PT0To5LLwxIEvtsazaBnTc,560 -awscli/examples/secretsmanager/get-resource-policy.rst,sha256=2l8CRns1aY7e99o3Tcy35Tw4mHnPKEUl5Eb4UtOxmR4,1033 -awscli/examples/secretsmanager/put-resource-policy.rst,sha256=TLNfc-2So8XMah4kHEZWna_hXwe2rEIU2-Jw-fVxpv0,769 -awscli/examples/secretsmanager/put-secret-value.rst,sha256=fxvAlQiLEmxqIA8ZiO5NBr6rdHWqj5IgDXJUKdloLHQ,575 -awscli/examples/secretsmanager/update-secret.rst,sha256=TzsCMd4Qy820g3Y7k0Y7yHqLZZYK8PfSXmHzVDPM1bg,1842 -awscli/examples/secretsmanager/restore-secret.rst,sha256=ifyn9CAd_pdjbufPW_22I4uOb6fMndCl7USuHOjkoks,383 -awscli/examples/secretsmanager/describe-secret.rst,sha256=WTdzTVAW3S4H_2Hdsdz18WLawSxY-IwNfOJC3wCtaYQ,999 -awscli/examples/secretsmanager/list-secrets.rst,sha256=pex5lAySXO-2krd3SkdvG0HmafQkQM3AvIU0vrVk5N0,992 -awscli/examples/secretsmanager/list-secret-version-ids.rst,sha256=yAs88_dFKiYU_4wFjF14cjmV9qkA-aJk4Kn1NehbJjc,949 -awscli/examples/secretsmanager/get-secret-value.rst,sha256=TEK4W11IKvwZK1BymO2ENlxzKD_iVyQoQQIQQMeiDjE,871 -awscli/examples/cloudformation/validate-template.rst,sha256=-ofrJZ6TQ6dEnuuPoC6Y5oOp-u6bqMMrJ2ab0gnrSIk,813 -awscli/examples/cloudformation/package.rst,sha256=0HRqwA8Ktr3e6AYYUuLdGzxkbhBIm0lQvyfM2uTJrKE,335 -awscli/examples/cloudformation/list-stacks.rst,sha256=zNU6DBt4c3kXn-PrVDSHLH7TaNoWEVDBv53czxNhThM,843 -awscli/examples/cloudformation/_package_description.rst,sha256=5tN4TH7D0zYecjbOo0uOra55hvYqc0tIkEnbSZICKwA,2762 -awscli/examples/cloudformation/deploy.rst,sha256=ScCk6_Zlkz9zeJYj-eN14Wt0HX_TfpW52mAd32ccYL0,279 -awscli/examples/cloudformation/update-stack.rst,sha256=FyGLvXIf7KLLuFLMdD7bDAc2a2vI0J4nhtwoYsLe7ZE,1266 -awscli/examples/cloudformation/_deploy_description.rst,sha256=tKFsU-kBgkYWmZhsyD8dqzdI15X_NGcVkp8h5V_odZ0,392 -awscli/examples/cloudformation/get-template.rst,sha256=yN14tJuVP4GVwvo1F29rEgxXDPVe-cqT_V4LXbstlME,1077 -awscli/examples/cloudformation/cancel-update-stack.rst,sha256=iXh30epVbKsksPDXoHLeoFQ5JMksU12FH48oflQ3BYU,217 -awscli/examples/cloudformation/describe-stacks.rst,sha256=3JCjcGNZQ-A7UiKP0oKhqjjKYmMn7aqgzBTS2X1zHNM,1435 -awscli/examples/cloudformation/create-stack.rst,sha256=humDEb33XPY_9TU6Geu-WOCHZ5Rk9ZZSP0Zj0kkVujA,710 -awscli/examples/application-autoscaling/deregister-scalable-target.rst,sha256=8tA3SHamqQ14V4DQzZYPNwmS9M4C5DxrqEuy1Ffh2qI,342 -awscli/examples/application-autoscaling/register-scalable-target.rst,sha256=YFFLhrzGGThNIWMO3Xi88-mfQbzJqzOo5pLlBRfiL9g,877 -awscli/examples/application-autoscaling/describe-scaling-policies.rst,sha256=iIqgR-JowrzndbenpbR26Ii38tjO2Eh8T4jMrwk_g2M,2528 -awscli/examples/application-autoscaling/delete-scaling-policy.rst,sha256=8heHjDwl-82E0APTXspj0uNrinREjGkadE1xy7aU7E0,345 -awscli/examples/application-autoscaling/put-scaling-policy.rst,sha256=ZEfhylV7ah03lgDxZjdaA1EGJIQBiDLhtHtEXZZy7_A,1103 -awscli/examples/application-autoscaling/describe-scalable-targets.rst,sha256=HasqS4UiMqxWn-aWHM9yAKsg5pHNW97k2N5NooBRr7Q,634 -awscli/examples/application-autoscaling/describe-scaling-activities.rst,sha256=YaSGAPRb4XYkBPmAnr9AUN49wa7Wze6P296j89tR2T8,1003 -awscli/examples/es/create-elasticsearch-domain.rst,sha256=JKOwWpWPPdtbD4AmTGz7ticZlPA7PCnkTFgWXrdplrQ,2497 -awscli/examples/importexport/get-status.rst,sha256=pZb7ikffnQnQhXAC5OcICs6II9sQzRxwsww5RbeYma4,1210 -awscli/examples/importexport/create-job.rst,sha256=R3zUSp77hfG_bY9fNKC6G_-N8hRKcbLcr--kXzt7-ik,1539 -awscli/examples/importexport/get-shipping-label.rst,sha256=gA9-UUrUTBrq1H6tIjP68X47wRtdQvos7ZkDUyTlDwk,936 -awscli/examples/importexport/update-job.rst,sha256=-PWfeHPEyYj5kA8rRaEF4eyEIyVe8a8XEn8I0PkXP34,482 -awscli/examples/importexport/cancel-job.rst,sha256=xMFerp-OpkIsGAZw_RDe0Dq1xqMxJgEi_5vdfr5O32U,237 -awscli/examples/importexport/list-jobs.rst,sha256=ZURf3LLRebhgR9idPmt3TUAcSUqkcJx8QA-vIH1iDD4,408 -awscli/examples/configure/add-model.rst,sha256=XqFvpf7laooxcYSPiXwCzf6PRmj4CghqWrHUygjv_fc,434 -awscli/examples/configure/_description.rst,sha256=Kd14crkdeUlluAzVCJwOtdgbGsjrsL8QUDIiFiBt6SU,2027 -awscli/examples/configure/get/_examples.rst,sha256=lVOwgQm7VtcfOnl8GRaFtBfQ6wZ0P7XHkA9F5nzL1Rk,807 -awscli/examples/configure/get/_description.rst,sha256=WusU6bxBIBpsCGocAC7umNm-u2zPtv0keXmNJVLhIVw,1936 -awscli/examples/configure/set/_examples.rst,sha256=-5sUHq5TNne2XwxQfrgF3iHI51ZUkJult0Tn5C75mWE,864 -awscli/examples/configure/set/_description.rst,sha256=XkzB3QYdeM9Pk_78O_ZfdKzW0CcIldRGgDvi8Ej4Wkw,896 -awscli/examples/rds/create-db-instance.rst,sha256=KINDWOc59dwvbm2Q4-Vm12pkhKIIJCXpfNVX3qb1Pt4,4159 -awscli/examples/rds/describe-orderable-db-instance-options.rst,sha256=yjKV67TbyFHgQZ9--JqNCGk-HsTJ3iRMX7vPEbUQsR8,1320 -awscli/examples/rds/describe-db-log-files.rst,sha256=jAl-0No6adxhfViZNTjud26kYgeUY7iFrOLxCW63_S8,1111 -awscli/examples/rds/describe-source-regions.rst,sha256=VsCJk99qUCejYnzD-e-LwTnxQuOQ9zXJ27nK36AMTZ0,350 -awscli/examples/rds/describe-db-instances.rst,sha256=aDLlBsYpvqEufM7eRG6zrXpz4DGEcUiEu0V84YgPn2s,611 -awscli/examples/rds/download-db-log-file-portion.rst,sha256=dm8elvH60DNEESEgGyk6jIp8GoiLp_k1brdJAz8fTk4,685 -awscli/examples/rds/create-db-security-group.rst,sha256=BFepvL_v5NWFYIe3PTpvxtcWiZVCkBCfKQjXiMnG9vU,695 -awscli/examples/rds/describe-event-subscriptions.rst,sha256=J22dOaW1Wm6nOqxuD3jkC00vQoMwHx8UxrqfKOnDQBQ,824 -awscli/examples/rds/modify-db-instance.rst,sha256=59nha4AUbjMaIM-hmdekc8bUWRGIrJ6B0pgEyS_Xvws,725 -awscli/examples/rds/restore-db-instance-from-db-snapshot.rst,sha256=iIHHkClVtIqofLS9l7LZ_Wiscg0JBlRN-9SIZtml4gQ,538 -awscli/examples/rds/describe-reserved-db-instances.rst,sha256=YipoBw--LaBEdLZPiesWUvwcIzZc18ogfBuVjInJfbQ,169 -awscli/examples/rds/remove-source-identifier-from-subscription.rst,sha256=IuuZ7FV6rNSYCbUTe8z2VMuaqUtg0lQmygLdre0cdgE,905 -awscli/examples/rds/restore-db-instance-to-point-in-time.rst,sha256=LBYvxjpBEfpXm0BwEXZpI6S8A3FzsU9WyHDJCFkrPxQ,676 -awscli/examples/rds/delete-event-subscription.rst,sha256=KjJcmXQmzULzII89vhq26HspqEHVnLQgmU6lvxOFMQg,791 -awscli/examples/rds/generate-auth-token.rst,sha256=uzURV4Bs5Z4LBzUFsVLpGFPOwSHHh4J7-Ix1igHkzxU,676 -awscli/examples/rds/reboot-db-instance.rst,sha256=bfQu0ILrLV4CO4etzMNeC94x2pHLYlOxyO55rO72qJw,580 -awscli/examples/rds/describe-events.rst,sha256=IBP1E2ysEGbea1ZaOkHSdNM7-Mp8dVVV5t9H99daWtM,971 -awscli/examples/rds/modify-event-subscription.rst,sha256=mruVEPozstyTf5ZFXhTb0noSFHIQTRT6HZNSekWEx0A,847 -awscli/examples/rds/create-event-subscription.rst,sha256=WsNxPGX1PIIevf_S2E0xzGGrTby02GVOlTyoTJKY1vU,1058 -awscli/examples/rds/add-source-identifier-to-subscription.rst,sha256=ZpzCA9682bVaNRfsErW_SrnGbyxCBlLfIG1azJk_YKE,928 -awscli/examples/rds/describe-event-categories.rst,sha256=BAksbAeGooocO6lR8XcLZvyt_lAbQus8HffgW9LUXxs,1633 -awscli/examples/rds/restore-db-instance-from-s3.rst,sha256=uCK7MJ77eAGq8Y_e-1qFh31SSCpclUTNI_ORJz2lNCA,570 -awscli/examples/rds/promote-read-replica.rst,sha256=EGdb4cFGjiHhh5bWExznMROhS6lA7k57sl14lSaBrSQ,527 -awscli/examples/rds/delete-db-instance.rst,sha256=eEjC9Th-drYzl0ZIihdcpD3RS9SEkY0mxJkDYvmQQSc,490 -awscli/examples/rds/describe-certificates.rst,sha256=aVbfAiHtlJOdCspX4ZbWswoePavhFxiqvrUlUZyzDuo,535 -awscli/examples/rds/create-db-instance-read-replica.rst,sha256=Vb2gtyvxnmH2UyXtkyUUJuuFVFLMdwPxqFtjG9T9d6A,697 -awscli/examples/rds/stop-db-instance.rst,sha256=gUxKF4KPmWyRkH17IJPn52hzlI-j5fsv5hRU_fRlQ8I,256 -awscli/examples/rds/describe-account-attributes.rst,sha256=6nGq21C0rSMVZWbS8tHlfUlob81hr3uAP9SlUVIJwZ0,1982 -awscli/examples/rds/describe-reserved-db-instances-offerings.rst,sha256=TKag_MDVSOGvoMuKFGKdQF7do5K2YpjD8gokwH4Oe3w,890 -awscli/examples/rds/purchase-reserved-db-instance.rst,sha256=Cq2XFPQUwKKmnmpxXofE_sy27rZy2R6RfheRPTd-QcY,378 -awscli/examples/rds/start-db-instance.rst,sha256=9Bp9NxOUBsLxuXxUvKUbymugNg6qJSxxyPncrLU3RZg,259 -awscli/examples/rds/describe-valid-db-instance-modifications.rst,sha256=f3e4MeE_TAaJY-pAe7bi4yU4-12ypH_2orTeyG7_LG8,2612 -awscli/examples/rds/create-option-group.rst,sha256=P9Lt9_VvXdo91oe9VAg83Ft_W5VRiFb1GJJLH96uhVA,778 -awscli/examples/inspector/list-tags-for-resource.rst,sha256=SffyIGt5VRPQGBTgaNRJau3n-xC48cGQkYjztxWS5G4,729 -awscli/examples/inspector/list-assessment-targets.rst,sha256=4oyfreVadlw2ujdmXrDgXNPVOVP5vg2abSXhtwQ8qTA,509 -awscli/examples/inspector/describe-assessment-runs.rst,sha256=G_trpXTdLIfb6HNGHk3_sadK7_4HGYZ0PdClxXgz234,2099 -awscli/examples/inspector/list-assessment-run-agents.rst,sha256=Ow5Ua1-DjT_G0vYyQ_632s8z5cLR63DmWWv9pN8E_4c,3709 -awscli/examples/inspector/describe-resource-groups.rst,sha256=PBy16e7Qve4cqK8R2Fnj0fopZy7RNwOJ3tDxKUiBkUA,825 -awscli/examples/inspector/delete-assessment-target.rst,sha256=t3xotVmFXNHDGa44DVlyegsDHrDxlurVDFd4APFajjo,551 -awscli/examples/inspector/stop-assessment-run.rst,sha256=89HBxG3su9OXpjVcPWyyGEsFGEMwoWsRfIDW7BrrIBI,640 -awscli/examples/inspector/list-rules-packages.rst,sha256=vYcXDWZRHHg0T3SjOGcPYzAT3McWXuI8hPpgqbRfJKs,724 -awscli/examples/inspector/describe-assessment-targets.rst,sha256=-mZiMooXz4b2RjejfSzx4VMSlaWLcjQv5AxWASDD94g,909 -awscli/examples/inspector/describe-findings.rst,sha256=0OCKyjBMBDFu3x7xN2TlshURGCVcs_6VaBPqLen0uyU,1649 -awscli/examples/inspector/start-assessment-run.rst,sha256=u3JoZuonYNW1t2pjw_leDrAXjT3e3RMYotiI5X_Be_4,839 -awscli/examples/inspector/update-assessment-target.rst,sha256=SL0rYQjY5_okzQuqAeLlREiNRl7iKR_iQt8NYjXdAao,808 -awscli/examples/inspector/set-tags-for-resource.rst,sha256=pHT_3b63jS0ZL8v8PIDkgMEPer38T_nnJEU9aRKnqVY,710 -awscli/examples/inspector/delete-assessment-run.rst,sha256=QyxVdfD_vshIhLSJjUJUhGfw6bpBi8TQdZN9gSvjNyg,648 -awscli/examples/inspector/delete-assessment-template.rst,sha256=XNaim1jS9Q-1-YN3__UOrJD-8sh_pNGONfWgLCa4bOE,643 -awscli/examples/inspector/describe-cross-account-access-role.rst,sha256=ZdU5c6DgGCcvQSTFAR_7R6trpu519GS1S_Ud06LeAr4,575 -awscli/examples/inspector/subscribe-to-event.rst,sha256=ghQH9lRPTBnxFDa3ocO2AC_aAZ12Q0HRLuJWX3Kcg-I,748 -awscli/examples/inspector/create-assessment-template.rst,sha256=Qnbf7_5CX4SWu6n23tzAqvzlBMJWTgIfSJImj86pufo,1021 -awscli/examples/inspector/list-assessment-runs.rst,sha256=RUKMR_vIeIwfPYCczlbYuz7Cnbczju_jOOsCvky6n10,665 -awscli/examples/inspector/describe-assessment-templates.rst,sha256=95-j5S1rhj3ESCk4dwhx2wfFv2DmonHh9LhYr9xqNWc,1158 -awscli/examples/inspector/list-findings.rst,sha256=446BaDoM3Zudqxy8ylh4OlyfVPcigGLFvAj8tCNUWvs,619 -awscli/examples/inspector/get-telemetry-metadata.rst,sha256=iYMY0Bjkbw7Y6W0O4j_VY5hYqm88lYE2bttvpiUqpJ0,3026 -awscli/examples/inspector/create-assessment-target.rst,sha256=tbkUX5gffoDxIt2ov9oMgclB0tAW6DzJJ4xhR_IMd-M,777 -awscli/examples/inspector/register-cross-account-access-role.rst,sha256=DX-FJaw0yHnklgOnTXVA4z0NyfQfC_AtSZdlFYF3aXM,640 -awscli/examples/inspector/preview-agents.rst,sha256=zfmZxAKP_oswzj4GUoiSS_MXkiM5zwwLNr9JEwgPtJY,652 -awscli/examples/inspector/describe-rules-packages.rst,sha256=M1iprwRzkZw-IQFab5qhiCcWi9HFqkqLuU2lUEv9a1Y,1646 -awscli/examples/inspector/unsubscribe-from-event.rst,sha256=36FGTpQ1VLkhFWUrbMhJPy8gCFVVOK7VKzavmcceCRY,761 -awscli/examples/inspector/create-resource-group.rst,sha256=n_IvTSSOb2x2MIpRq8kse4Xg4zYlV1v5xVnR1e7GYGg,585 -awscli/examples/inspector/remove-attributes-from-findings.rst,sha256=_alBa8MI00VuS4YhTbjvJSc0XZIn04w4hL3bvytEeCY,785 -awscli/examples/inspector/list-assessment-templates.rst,sha256=jkOUTwcgY0kXuduJuJVqH5OYWCJkyL7-qxFy3ImJ3b0,667 -awscli/examples/inspector/add-attributes-to-findings.rst,sha256=XpFiu1-KcFrgwg3KYpcxrza55eb0dSEXGKd5t-C0WsU,766 -awscli/examples/inspector/list-event-subscriptions.rst,sha256=6xaZ0Bf69cbeuqDqLWAEAr3rLMkNS4FYAJaEZ2z_ma4,985 -awscli/examples/elasticache/modify-cache-parameter-group.rst,sha256=WvofbE753d04EaOxFgvzIRqJQuHPMSSsXXSgHxqHbhc,408 -awscli/examples/elasticache/create-replication-group.rst,sha256=Hb44cmWE0oDZusH-m-ozzfB5Oi1TNJAszOeuOAke7q4,898 -awscli/examples/elasticache/modify-replication-group.rst,sha256=WQkYk74xFGgSYjtXOR7jibby0WfsU_V--cxPd-lF7Cs,495 -awscli/examples/redshift/delete-cluster.rst,sha256=flAxqcZ1mKoqOd_XG73TXf7r2gVpCW26cAKGOe5z1jc,603 -awscli/examples/redshift/describe-reserved-nodes.rst,sha256=uMBsIZKBDLZ9orPMWssJNI8ckAAjZt79LIgADKl8Uo4,994 -awscli/examples/redshift/revoke-cluster-security-group-ingress.rst,sha256=KnT8wIwDYkWyUy7rFgsPWRjWMV0s68Sam6yvU9fk1CU,603 -awscli/examples/redshift/create-cluster-snapshot.rst,sha256=O-qnFUyfte7v4W9-iOhIvknvINASlBn_Q1VRv1-GSVQ,939 -awscli/examples/redshift/modify-cluster.rst,sha256=YK2Y50x2gLrdjNyACxm7KXiBBJ8XjueZNbBJaOiP0WQ,945 -awscli/examples/redshift/describe-cluster-snapshots.rst,sha256=Ce7P6zM8dvU9Y864ba5wMF9hG195kVEnzXltzTFcWNc,2445 -awscli/examples/redshift/describe-cluster-versions.rst,sha256=DwQDu7GRUsQcRXBzeAkuRmFX605gz8UxuJvxPIrX0TY,556 -awscli/examples/redshift/copy-cluster-snapshot.rst,sha256=ZLohE17BYbmFmJ_npRQ5CsA7Rm1iRATLxkZiy4auqfw,1049 -awscli/examples/redshift/purchase-reserved-node-offering.rst,sha256=uproTrYFSBi2CCVmkQmEqLby0_Ncz7rA0frVUkvT36Q,1096 -awscli/examples/redshift/create-cluster.rst,sha256=98_C9a5EGDex9he_NPpjSUEFImyPdvwEj91zBlgOMIQ,1446 -awscli/examples/redshift/describe-reserved-node-offerings.rst,sha256=Wa3AdmzAMJZHzw7u3XXQLez8WRifuPy7PzkUj3yhDCs,1499 -awscli/examples/redshift/create-cluster-subnet-group.rst,sha256=PfhedJyQXJd5D271HbhVrzSArxVf1B3HsTgesBzXigI,865 -awscli/examples/redshift/describe-cluster-subnet-groups.rst,sha256=pYBO10zZs2x4Jk4UfVlgMYTnSja-cyOU1fM4Ickt00o,930 -awscli/examples/redshift/reboot-cluster.rst,sha256=GoN-d0bt3F47_6nxKfU1yHPrYATk_WoIroQBSGYQafg,1459 -awscli/examples/redshift/reset-cluster-parameter-group.rst,sha256=eGLrNCbWJHJR3MSW4gTmc9p3MXG8sZVpokadTiwA0dM,282 -awscli/examples/redshift/describe-events.rst,sha256=2EvDWad-0P9U1X8c6ckhQatUUJ7LPLx5DGl4jc7onww,937 -awscli/examples/redshift/authorize-snapshot-access.rst,sha256=XRU-AkvIYLYcHW3xoHJbYFxu-5Pn6qL1cCN1irDizAQ,1301 -awscli/examples/redshift/describe-cluster-security-groups.rst,sha256=TCg-gPPs20q3Vq1WR_uaa6WPI-llT_h3Ie7lPVf0OFY,1010 -awscli/examples/redshift/delete-cluster-parameter-group.rst,sha256=DgXjEOjR9X7pVnNny7kUDacvQNXPCGnrctW6BPHuDYQ,222 -awscli/examples/redshift/describe-cluster-parameters.rst,sha256=r-Y71sN2B5DyoBV1SVAILIWGojgQlDHBocc5y7xWDHI,2217 -awscli/examples/redshift/modify-cluster-subnet-group.rst,sha256=DNUT-gQMf6hpqwcfcyzqJgbkv5JYoG1GAuQ4_QZLXxY,1152 -awscli/examples/redshift/restore-from-cluster-snapshot.rst,sha256=2pHT2hfkURYQ9Nq31u40WZR-2Di97wqHEaj61Qaq574,1281 -awscli/examples/redshift/modify-cluster-parameter-group.rst,sha256=ofs1wr0lu0JrDOTejPr2N0tDZ6B4KHfsOaYI1o2Y9XA,822 -awscli/examples/redshift/revoke-snapshot-access.rst,sha256=Wp5mVGjXKyjbtaaDTGaHuBaduBAVyOCbBfaSbgHf0Ms,1351 -awscli/examples/redshift/delete-cluster-snapshot.rst,sha256=PPtM_Y70IoU5ZTYu6v3_7wu9z6ML-1yNXCwbpt9ZkF8,184 -awscli/examples/redshift/describe-cluster-parameter-groups.rst,sha256=IUjoDJF3nbcmJWduDbufsjw8tkV5YIeO3DeUxZFU93w,981 -awscli/examples/redshift/describe-default-cluster-parameters.rst,sha256=K7qRFUMqXntWHuIxOw9v8N96FCeQ78PytukJnHvnDAk,1310 -awscli/examples/redshift/create-cluster-security-group.rst,sha256=kfQgpnrOarmjiG0j-BLW4wypbKjI6Snwx9t2vz02jzg,1268 -awscli/examples/redshift/describe-orderable-cluster-options.rst,sha256=BlmfUke6a2QxybYK-FG3Gq7RwfoubWC7XcKhParfW3Y,1806 -awscli/examples/redshift/describe-resize.rst,sha256=8OEE8U2oMZaLuRktskzcLXFoBsFuxbzBVdMuJdoy7fw,488 -awscli/examples/redshift/delete-cluster-security-group.rst,sha256=YeqLPOembq6iYJov_j3KcPBmUFKIvBo_b5R2_8DAz-A,217 -awscli/examples/redshift/describe-clusters.rst,sha256=mXosi6u1BO4nr9Q6HcHFIXzy_6F8cI2f8MdFkGVsDFo,2005 -awscli/examples/redshift/delete-cluster-subnet-group.rst,sha256=ouAGJPQnhhF8p_omq9QOMapJxeo1AlWIcoKsIGgt95A,329 -awscli/examples/redshift/create-cluster-parameter-group.rst,sha256=sSWLR5B5xoOhZxt6bs-qXIihbkJdm2O1Z09alRTA9xg,650 -awscli/examples/redshift/authorize-cluster-security-group-ingress.rst,sha256=dnOvDRFO_M9tnaXPTkFJEBOufJi-Vrb9YjKU3oPusCw,626 -awscli/examples/cloudwatch/put-metric-data.rst,sha256=bLFC5gwHvntIXiGv0LFhRaEd7jC27sHqeWzl3cVtMgA,1126 -awscli/examples/cloudwatch/describe-alarms.rst,sha256=Xx62GZDNqLCWMqmwpfcoyFN384sD9D_TVxGtoD9s0u8,1751 -awscli/examples/cloudwatch/get-metric-statistics.rst,sha256=2eW5dmXky_oYy7bgJKFyjfZ0_wDhvOsAmA3D1igPteg,4916 -awscli/examples/cloudwatch/set-alarm-state.rst,sha256=rDkHfPCup5cx4j37z-Y2dF4xSl8jsbS07EYo0WdP5mY,401 -awscli/examples/cloudwatch/describe-alarms-for-metric.rst,sha256=p-2dFjgRRhI2UaxuL5jyPM5tmq186SWRPRm3DvaHT8I,3562 -awscli/examples/cloudwatch/disable-alarm-actions.rst,sha256=zKpiELbmWk7HBvpusZYj1Hltzrl3N-0U0DhPWnS3eVE,270 -awscli/examples/cloudwatch/list-metrics.rst,sha256=CaAAZFbW3-RamH8VA5S8L-oye4rtCjXPec9eAAC0vFY,2527 -awscli/examples/cloudwatch/describe-alarm-history.rst,sha256=nDAXGrqpi628a9-qkeNejUARZzP5hQWY60hCt1pHpds,1898 -awscli/examples/cloudwatch/put-metric-alarm.rst,sha256=6VnpT0S0xIxdEO59HB4kPqXYUmmheOkWjWrrzQktjPQ,1412 -awscli/examples/cloudwatch/enable-alarm-actions.rst,sha256=xcyA_t0kcw-eVVkLpdZiuicKwqW84sw4NTrN5sJIl8M,270 -awscli/examples/cloudwatch/delete-alarms.rst,sha256=BKs1LQkjwJ5NsXMvyKqLSwmewY4PPu8XkEWHxOgAskY,254 -awscli/examples/elbv2/create-load-balancer.rst,sha256=HqT1uDnxMQOWuHy9zj_io6ouvJYnzbI0u6U1H53cllw,4487 -awscli/examples/elbv2/set-subnets.rst,sha256=-2ihgZI_4JorQj8HenMlHhIwhpfFHnqpdjk7zjI4AsE,631 -awscli/examples/elbv2/modify-target-group.rst,sha256=MW94dThKR_DGaHjc-SjB6q_aaLJbIXgJygGvz5fwJpU,1291 -awscli/examples/elbv2/describe-target-group-attributes.rst,sha256=2nGV58IZKdJ1KYEXKxaIz3UiB2bIv-M_EjlKFF9DTkw,752 -awscli/examples/elbv2/deregister-targets.rst,sha256=jBHYwvPwEVP742sgOJvKrNj4NCGLsO8SgX8D5z0vMNg,680 -awscli/examples/elbv2/add-tags.rst,sha256=1oJ00_pg0RezaF5XZfEFmtVyjPFfCfQ1K2alFzQgCyw,333 -awscli/examples/elbv2/modify-listener.rst,sha256=_jVQ9mqwSEqgecKDcIpEI_pt_Eq1zIDNZ3dLUVdon9s,2413 -awscli/examples/elbv2/describe-load-balancer-attributes.rst,sha256=-VOitf4jkT-3jCrsaGLXkAvkZZ8aJZkMJ1i_0R5bAlE,842 -awscli/examples/elbv2/describe-listener-certificates.rst,sha256=SKKkSHlWYj_XPTJ3G451-uFj2WoDHlIdLBHotnh5XyU,895 -awscli/examples/elbv2/register-targets.rst,sha256=STkkNPEN0q1VC_bbgk2z27DHQP6te7gHocqSSDThVVM,1224 -awscli/examples/elbv2/delete-rule.rst,sha256=8w5XLqDqbmkOh3MKFa1xWSzizgUCewyw2EIsSmlAgd0,255 -awscli/examples/elbv2/set-ip-address-type.rst,sha256=1V50gf_3Fn3e4S0E5in8eaj0J4E_WkteLb54qlbLbDc,508 -awscli/examples/elbv2/describe-rules.rst,sha256=fa9yiDHEdI2yaNow6Zm7FfH229vgEHiNV1bVlkDd9Dc,3442 -awscli/examples/elbv2/add-listener-certificates.rst,sha256=V_A-7YYUxbV7CAUXrDwYevp2NPD7nq9_YFaibQ3uI0I,653 -awscli/examples/elbv2/delete-target-group.rst,sha256=d0B9tXh_kHvtomc7TtnA6oBJXzGJaUCc1aFsxPp43J8,241 -awscli/examples/elbv2/describe-account-limits.rst,sha256=8RtkEo1fKsTln1WQ6V8Tb5fH-KpeFn99dYPkULOJ-mI,1065 -awscli/examples/elbv2/set-rule-priorities.rst,sha256=y5qVsf4tCO4OGSWVE3VPQnymHdwtXe7SjakAjPtaRhQ,1078 -awscli/examples/elbv2/create-rule.rst,sha256=4AFOeNAdvbMRwV3faBNIKZ_-BGxdJBYKihexdgak-jo,2695 -awscli/examples/elbv2/modify-target-group-attributes.rst,sha256=3wYpHxzFphqXETVo0irDPK9NqSMJCHT3Xv5Lv2B3LQk,858 -awscli/examples/elbv2/describe-tags.rst,sha256=lGCbvR8Fm8-UOFCpVVeT0G31dCa8H9QTO-x27qi2d4Y,785 -awscli/examples/elbv2/modify-rule.rst,sha256=-8ODyG7B20xoDujasaL0G7xNx3L83sdLkViTvN0UGD8,1097 -awscli/examples/elbv2/describe-ssl-policies.rst,sha256=BuQxuu0ws1EenMH0zHgON2w11BBzpB_IgLOahgL64w4,1240 -awscli/examples/elbv2/describe-target-health.rst,sha256=0Q7yWPH5jXLUMtMBxiA5RBzCj4tuse6hGq2sYunZH4I,3144 -awscli/examples/elbv2/modify-load-balancer-attributes.rst,sha256=J3MzE88RLJPu0TzFoi4hQlMJf3UXclOkt0z26W9m0UA,2940 -awscli/examples/elbv2/create-target-group.rst,sha256=ktlCse6ZPfwL68HcUllVIA552NGk_x89GXXg_Gqa8sc,2752 -awscli/examples/elbv2/delete-load-balancer.rst,sha256=LhCbfZvnfqAy44rYT3yVdBT-q_nlVlDMytk8r54ONlI,256 -awscli/examples/elbv2/create-listener.rst,sha256=M0hKqeg_z17EiHIw6sSN8ocUGh33EyMpGaUknTiMz6w,4323 -awscli/examples/elbv2/remove-listener-certificates.rst,sha256=GPW6x3UKfVp_7GNZukXOXYsT0ooo1Uro4t2OcrXLvQ0,440 -awscli/examples/elbv2/set-security-groups.rst,sha256=g1s2WMJHk7CJz8nXjFI-G4lq8gQ6CaJAZazaJ7XG1y0,428 -awscli/examples/elbv2/describe-listeners.rst,sha256=g0mUERsiVcFKhr2RLPkspAePapGbs3kRbP6XyxYp7Dw,2772 -awscli/examples/elbv2/describe-load-balancers.rst,sha256=O8qlSl7UcavqoiFu41A5vuWFxYwobBrG-4riwBvYF9s,1505 -awscli/examples/elbv2/delete-listener.rst,sha256=WxYVUqYxTeGIvFKLuTh0KuJEAMmYq1Tj7FxK6pfXcUs,249 -awscli/examples/elbv2/remove-tags.rst,sha256=O5TSFsAkW9U6DKRE35f-7CpFtdz9neGK9pAjm7F754g,307 -awscli/examples/elbv2/describe-target-groups.rst,sha256=ze9YlFfDvYQfETUSc3k0aOuxLF_u3LhCbzRyVkAMhQk,1635 -awscli/examples/elasticbeanstalk/describe-instances-health.rst,sha256=_axf_RKu1JGZFEVbAGn49HxcYiLE-xVZMQ5iERxgu8c,2052 -awscli/examples/elasticbeanstalk/list-available-solution-stacks.rst,sha256=2fqQ73Gvitv6jwsrfB10PbVBWTGXwiUKnycD5RgmPmI,2560 -awscli/examples/elasticbeanstalk/describe-environment-resources.rst,sha256=qz4JRwlQ5VgXcDPcYOcvVZnm6m_qOD34VGbcEu4T9FQ,986 -awscli/examples/elasticbeanstalk/swap-environment-cnames.rst,sha256=iVwSkBlhbJxFgRULsKyt-2XNJr-IWZAeE2m8DQCtq8w,236 -awscli/examples/elasticbeanstalk/restart-app-server.rst,sha256=vCtqKoqetOaUL92VgMKSRzlCDrju1stJ-6fMHvG1xgY,210 -awscli/examples/elasticbeanstalk/validate-configuration-settings.rst,sha256=D60aCAASQYfdZ_2dpXRA03w-rv4cuuI9AkxRwvL5nJ4,2712 -awscli/examples/elasticbeanstalk/describe-applications.rst,sha256=D2cdubnUVP-rp-W2zecefjpxmt3sronwfudTEBSR92Y,1276 -awscli/examples/elasticbeanstalk/describe-configuration-settings.rst,sha256=0oK3NMU7yWRWgN3kElD8m1MQ5ct2EmIZWdMEd5P9qJo,2095 -awscli/examples/elasticbeanstalk/create-storage-location.rst,sha256=9k0Hr0miVqnQ_oxRRAJoyFGYTHFbwZXhd9xH1wTH70s,226 -awscli/examples/elasticbeanstalk/delete-application.rst,sha256=84bX8EQP-NURpfgHbTXFQFyAeUyTmZEUwQTMTAcHU8I,163 -awscli/examples/elasticbeanstalk/describe-environments.rst,sha256=GOVuIA0_Xzxvk-yoIYuhEYxZv2eebpTb4SKhcv_6Wgw,1106 -awscli/examples/elasticbeanstalk/update-environment.rst,sha256=3eW7n0yXj293F1oSxe-nQnk2Yk8hlwcHeRGi7BsBMcw,3234 -awscli/examples/elasticbeanstalk/delete-environment-configuration.rst,sha256=HHBgVrSZZRxp80IeUttcvSrqwlf9KTlqrz9o6TehZXg,236 -awscli/examples/elasticbeanstalk/describe-application-versions.rst,sha256=G6j61WrqsntKbDXnOpDAAW5M6PMhPwupxdpBHeiI13A,1186 -awscli/examples/elasticbeanstalk/terminate-environment.rst,sha256=nX3RSy3FLJ7hjig6e1oipkprLb---poWSQNgo2uBNN8,855 -awscli/examples/elasticbeanstalk/create-configuration-template.rst,sha256=aNPM10V2XFE6hb7ST83dsEpO6xQLZfHG1NoD8MI1_W8,592 -awscli/examples/elasticbeanstalk/rebuild-environment.rst,sha256=oIXi--vashijMSeMMqeHe-cgZhFlLheWDrCxm5w8G20,199 -awscli/examples/elasticbeanstalk/update-application-version.rst,sha256=0QeTykG8pJfKCntAfy6YB-r3qxC8-DT-5XA7IsZMcG8,781 -awscli/examples/elasticbeanstalk/delete-application-version.rst,sha256=3uBeCfemfHdbcESkTmz96WTS_yzD_MS9Oc0a8Ybe5W8,282 -awscli/examples/elasticbeanstalk/describe-events.rst,sha256=4SpfSjaD3C5e0qpOcKzuxhJYZLISoCvKxCQ7f9ugzSU,1586 -awscli/examples/elasticbeanstalk/create-application.rst,sha256=xyJsWMauaGoBR2UOA8iuRhrE3lByHSlKsSue-0VAwNk,832 -awscli/examples/elasticbeanstalk/describe-configuration-options.rst,sha256=EOFHrTk5sGfnSeAurLj4KtIifuyTpaL0wYGWVBdNXZE,1916 -awscli/examples/elasticbeanstalk/delete-configuration-template.rst,sha256=dzm8uvQgY8cMwrXLLxaPvv8zbnF08ffiZrYqdsrgzUc,263 -awscli/examples/elasticbeanstalk/create-environment.rst,sha256=Mg9T_nbAtNYZQrfKslgmGfR0YzwGtxwAwDIoh57Gvwg,2253 -awscli/examples/elasticbeanstalk/update-application.rst,sha256=M4FneRgiO7RARFq1YyXQlQCCWb7SI-vxDCzkwO1F4qA,766 -awscli/examples/elasticbeanstalk/create-application-version.rst,sha256=EFLMy6CzmmRMS-hgDmrh89yH3ptJVDgaEEKRGzfQ_S0,932 -awscli/examples/elasticbeanstalk/check-dns-availability.rst,sha256=854YdaUn88poVD8Iu4vyHcHDqZHQXShAyL_JtR2Qc9E,317 -awscli/examples/elasticbeanstalk/describe-environment-health.rst,sha256=eWzL6zukiySyQ8lhmY5IjGjzfVn_LNkT2mA_Dsd8BBc,1499 -awscli/examples/elasticbeanstalk/update-configuration-template.rst,sha256=egEL1qkCNdmsDDg0LTWegAYznbmueYYv6yXqwHZHFVM,915 -awscli/examples/elasticbeanstalk/abort-environment-update.rst,sha256=AEyTYbeHZjoNtj4sxKxYcJgjsSLJ2vkw0kcqCtXlNtU,210 -awscli/examples/elasticbeanstalk/request-environment-info.rst,sha256=j4U2VTVdMnwjRG_w6zMeL6vzgLUkVTCdATjyrrsSalk,408 -awscli/examples/elasticbeanstalk/retrieve-environment-info.rst,sha256=vA39C8lgUNbjxgHqKt2iAUmnupyUjgjWjHJY7UrpZAc,938 -awscli/examples/acm-pca/revoke-certificate.rst,sha256=hNlFZ9cG37zV7vo92rRNhrsDWByqjCJ-0yGrUnKMLDQ,365 -awscli/examples/acm-pca/list-certificate-authorities.rst,sha256=3FKsAZ69X4p6qUiigfXBPXyM1DrwBBTMbjICNKv7eX4,224 -awscli/examples/acm-pca/create-certificate-authority-audit-report.rst,sha256=h9o7myx1qT4OTLvVAcFVZpuQe4QzqcyIY6ablFrWmsg,407 -awscli/examples/acm-pca/tag-certificate-authority.rst,sha256=6jwU7JJigVwGySX5pTH_kkQLRdtFkSf9SE1HlK0E71Q,335 -awscli/examples/acm-pca/delete-certificate-authority.rst,sha256=XZpHCJPGxI13lM-MRlTzQvayuvA0mIrd65pLP9zEYT0,263 -awscli/examples/acm-pca/describe-certificate-authority.rst,sha256=NImqFlAXv103PUnI_2o3zLSxa8GPFJUxLgrac5VSUB0,308 -awscli/examples/acm-pca/describe-certificate-authority-audit-report.rst,sha256=IqlohgDFXl5t-JpZZJHpQzm-eIbaSubeSj1sOrEsmGI,403 -awscli/examples/acm-pca/untag-certificate-authority.rst,sha256=Loba5zYwj8hPrmPhOR6iARYQqrFu70bgVPTlkG-QZlA,349 -awscli/examples/acm-pca/issue-certificate.rst,sha256=MyRnu9gtmxTBrufuBNphSSzaCrwaepCLcGrLgeixeXs,399 -awscli/examples/acm-pca/get-certificate.rst,sha256=lFim0NkwPSbx1o7A8kj-5m1SvuuxpeP-KcmgKk5jNJ8,442 -awscli/examples/acm-pca/get-certificate-authority-csr.rst,sha256=wj7ZraiK_kp_ufxzFObh3fQ4F1j9CfkeP0AFvHWa2GE,343 -awscli/examples/acm-pca/create-certificate-authority.rst,sha256=oiX3Gci0gZ6Vnr7g62V2FxdD-T6xGEEA6oMVxGPEbIA,390 -awscli/examples/acm-pca/list-tags.rst,sha256=8wPz3_ZQnnD6nNxJxc4ZeXx7HUIf3Zgyl-pkUDxklzQ,292 -awscli/examples/acm-pca/get-certificate-authority-certificate.rst,sha256=jBm-lQubcc8hEZo3jtASN7toiH-myskIYqdTRIhxNBw,370 -awscli/examples/acm-pca/update-certificate-authority.rst,sha256=44beZ-sIo25y4zy35wCxAmTKlTpkNZ_lOQ8HMXA_tY8,415 -awscli/examples/acm-pca/import-certificate-authority-certificate.rst,sha256=4P1w3HSCuOJaDP5cNgLAz8nl3LojOG4daqtlj_b5oD8,443 -awscli/examples/directconnect/describe-locations.rst,sha256=LGDOhY_V-HNZBlBS-du_D-pTgTdnboL-BbnBG7Eg8p0,543 -awscli/examples/directconnect/untag-resource.rst,sha256=WPZsBWbmoy-ozhm-E1YtNjqoUWsVK9pWhgUVNJ43IQY,354 -awscli/examples/directconnect/describe-connections.rst,sha256=wBIlsvg8nUeAZXaVeH55n-EjWpmuYMFeXV8p7x24Apk,691 -awscli/examples/directconnect/describe-interconnect-loa.rst,sha256=BfHgeSrDUEmvYLBzlV0a-S3wmSYlbxD7zWaA_yILvRs,1682 -awscli/examples/directconnect/create-private-virtual-interface.rst,sha256=xbXugtf-1eZw0F5X_GcSDNJZ0d7diFO6L9xLSAtZSJc,1443 -awscli/examples/directconnect/allocate-connection-on-interconnect.rst,sha256=lnng4LV7AwU5P2cBHqhN3tnRQBf0KhEOWYsHa_tw1oY,687 -awscli/examples/directconnect/allocate-hosted-connection.rst,sha256=IrP-dpbRew43iLTC4SZ6LVB5DBScyBPI_GTRB4D5s-U,658 -awscli/examples/directconnect/delete-direct-connect-gateway.rst,sha256=fnWIcJ4UFG-zzAuTI6yzsLZr7uX5P2MxFiCHSh17-TE,579 -awscli/examples/directconnect/delete-bgp-peer.rst,sha256=YG4Q-8tvJZhNQnSFEJYR1cK4q7jkKClox5sP9VTCYjs,2209 -awscli/examples/directconnect/confirm-private-virtual-interface.rst,sha256=sFGTLCdYSRW4ZSxHcdeUSRM7jS1dea50zELBreJFgQk,391 -awscli/examples/directconnect/allocate-public-virtual-interface.rst,sha256=4m7Ip_D93LkKpbGJ43gbT7qoZjVybU6CamclkReXRq8,1660 -awscli/examples/directconnect/describe-connection-loa.rst,sha256=xow_m7RGSDkSB_YIQl8l8n114MyXdQwaPv8JKXzVkiQ,1664 -awscli/examples/directconnect/disassociate-connection-from-lag.rst,sha256=CCzS7KUow95pgQ4P_tMALhJDRaf56yNTVfShruVoDQU,518 -awscli/examples/directconnect/describe-direct-connect-gateway-attachments.rst,sha256=HDOKz0aj8N9FZu-BrbrQ9oUf9tsUWrKhSVGZXnPngfs,959 -awscli/examples/directconnect/tag-resource.rst,sha256=Fl9wjEDapBoZemJVYAJeGAV8wjgergThKN4yqQzE4Dk,398 -awscli/examples/directconnect/create-connection.rst,sha256=1copju4pfV3GNmuutUAUJvhpp0qYxQT2jfWPopQw668,595 -awscli/examples/directconnect/allocate-private-virtual-interface.rst,sha256=a_oEHZGuQOa49Kehk4hlMn5LRpCYYRU10Z350oaZNcY,1465 -awscli/examples/directconnect/confirm-public-virtual-interface.rst,sha256=M6fVCeroKb7xSs3VAh1IQNkq0-psHqTsG6ylCgfmEkU,355 -awscli/examples/directconnect/delete-direct-connect-gateway-association.rst,sha256=8oJNtrkGslT8UQ4ClRLOL5eQdRBBPlgit6KgO5QUYXs,718 -awscli/examples/directconnect/create-public-virtual-interface.rst,sha256=hXlgVTiHlC6SQBjSXtr1bFDifcKS7LES9mmWupD4khY,1573 -awscli/examples/directconnect/describe-tags.rst,sha256=KFXQt47SpUawoyc15mfVa7wuzpq0c1_Hzic3dUYBbDk,605 -awscli/examples/directconnect/create-direct-connect-gateway.rst,sha256=29cct0eWlsJCw74-MF2IbjoRjvpvRMZMAzL1YxphugQ,552 -awscli/examples/directconnect/describe-virtual-gateways.rst,sha256=25uPpUxlfu3iWmZs2REP6-FaqtleawgtrJsZxRv1jno,388 -awscli/examples/directconnect/describe-lags.rst,sha256=yimikVLjoCV1CeYER1ZkMIotonsZyu98TbIBPhqTvpA,1607 -awscli/examples/directconnect/describe-hosted-connections.rst,sha256=Mxl0cErHQ79BfZWGfmz9qwfmryxX3_WHkkmPtesF9xM,699 -awscli/examples/directconnect/describe-direct-connect-gateways.rst,sha256=8C5QHyX-DykpM9KpOz7xAyf44kyExPGEla1gZcQDa8c,842 -awscli/examples/directconnect/associate-virtual-interface.rst,sha256=1x74VLr66Udhvky_zutnQrjFMlnb9PkvtsV3g9dssnI,2150 -awscli/examples/directconnect/associate-hosted-connection.rst,sha256=Y4nlXbY7GSNA9tA9McR1IBpQ84UeJbM-1EQHnaEknvI,621 -awscli/examples/directconnect/delete-lag.rst,sha256=Y_d3R1jwO8gka9s-aAMq0Y-3y9ioiE79az9Z1AT2mkc,510 -awscli/examples/directconnect/describe-loa.rst,sha256=B7u4IwBjhNMeobZnLTKtqePiDc-5zbEqRzy0yIAw1RM,1642 -awscli/examples/directconnect/delete-connection.rst,sha256=_tXt3oTBgfDOOdXkxbEYdroK2tLmEMhTseGmHnrB0DE,459 -awscli/examples/directconnect/create-interconnect.rst,sha256=eE0O4IJZfeDmKzJctf4jHq8GhAWOlswpVFzjUhaLyoY,606 -awscli/examples/directconnect/describe-connections-on-interconnect.rst,sha256=lKcWAtqJdQokia4XhToklnEgDbL2PPgYkL5Fx6rgv1A,739 -awscli/examples/directconnect/create-bgp-peer.rst,sha256=NH0dFu4mW4Mlkw_y04JaPteensj-Oq3izX2rJzZmcaA,2529 -awscli/examples/directconnect/associate-connection-with-lag.rst,sha256=46qC6A2KNPwYubJP6oTanOcEaqjMMA88mAdRvU-RqQ8,539 -awscli/examples/directconnect/update-lag.rst,sha256=Wp9A_B1KEmeDcUbJPruJQi9iErOMPn6ZVwKW9G57NLw,1331 -awscli/examples/directconnect/create-lag.rst,sha256=GcDbyPYSrMy75bHxCLzQKrDBrBl2_aPih67dZh_Bd3o,3001 -awscli/examples/directconnect/delete-virtual-interface.rst,sha256=NGPMpd4zEHcwQ5ZCcB4yat8ryBIFKnwzL6am-eVE14o,282 -awscli/examples/directconnect/delete-interconnect.rst,sha256=CXOl19pUKMkrvyzgEpfgvEp5bMDJWZw9ATnO2BlzJNk,253 -awscli/examples/directconnect/confirm-connection.rst,sha256=QpvNphGMssJXgszTlpUj1Yf9sla284IxleMIBoAkZoA,318 -awscli/examples/directconnect/describe-direct-connect-gateway-associations.rst,sha256=rOEBPNsQzN_17Q-JLHLwIPJ8fH7TXPRC9SXn0gmJKxc,1253 -awscli/examples/directconnect/create-direct-connect-gateway-association.rst,sha256=vc6b5oPk2DJVwRN_IgfMkXbGhKLcnTdzUbcAvFHVeNk,822 -awscli/examples/directconnect/describe-interconnects.rst,sha256=02esJq5B1Mu65txM5_PUbnLlzMuILu2F-OlhZ3cA4rc,531 -awscli/examples/directconnect/describe-virtual-interfaces.rst,sha256=gZoxAHutvJ8oqp_AVTWyAMNtX4LcCemK0D4fG5dnozY,2766 -awscli/examples/dynamodb/query.rst,sha256=YOl_SBPElT1ufzVXXVUd9mCSRfFDQh9eW9vQYxkm9Q0,950 -awscli/examples/dynamodb/batch-write-item.rst,sha256=IROW7wJ6lQZ2Wqpz2ZJwEZ2n1ACvIzBEPxqTUZt3wZg,1337 -awscli/examples/dynamodb/update-item.rst,sha256=q8_5yLZGGwTYX4x5h8NEaK6VOqT__PSLducG1G6FEJ0,1443 -awscli/examples/dynamodb/delete-table.rst,sha256=eUNW5-1FcVQdCJf7PLXdp2UO24SzzZkPAuFo1Y7Yves,507 -awscli/examples/dynamodb/list-tables.rst,sha256=fwrxCWjVLoHbKFAW1eQUU3T7DYuZI5HJHIe7XIpUWTY,288 -awscli/examples/dynamodb/scan.rst,sha256=q_jYt9nJQVOQ9VNvh39lan4RX0dKL7B22PKjW-jBtJg,1423 -awscli/examples/dynamodb/delete-item.rst,sha256=KbtLfmlyssE6D6jZB1bYHByP2ZjUKU0sKNuArrZ-1KE,512 -awscli/examples/dynamodb/batch-get-item.rst,sha256=VSrzeAX4vGFDd6hoenCVgONacu3VwjIRJl-aVfoLPqg,1470 -awscli/examples/dynamodb/update-table.rst,sha256=qwmyeEUh80M1pNN-S0IqMTdiihW_a4vxSpnPjVfoU8M,1310 -awscli/examples/dynamodb/get-item.rst,sha256=YIyI0BrwCZDHOVyXtP66LrIRLBtZU9IFK2XdoUEGgFY,750 -awscli/examples/dynamodb/put-item.rst,sha256=ltp8Mf3D0ClewSFgR-jZqYwCCFWEiyX7wep7CYX8ouA,1190 -awscli/examples/dynamodb/create-table.rst,sha256=GIu6GgyO-kUp-y0hM45pjMX7v2YmDfb_TVFMwgcLLUs,1373 -awscli/examples/dynamodb/describe-table.rst,sha256=7L7uJzVM4CylfgZFCQnbq8WW_NYeVyccsHJZK_FAb8M,1109 -awscli/examples/apigateway/get-domain-names.rst,sha256=H1rz_W-LPQU9GlxaHVh0FkQWGRJGiVsuot8WGKW94x4,397 -awscli/examples/apigateway/get-model-template.rst,sha256=v3ysi8gZSUlcXQl43AgqHPY4wWqPLRo4VExjIrQ68CY,239 -awscli/examples/apigateway/get-model.rst,sha256=L3zLc1unE6GvJATii_FbeG8ubngrYQ-GimPY-kOIbBk,462 -awscli/examples/apigateway/get-api-keys.rst,sha256=rKkKJLcuu6RWsAzwYA2lVTkv8zzTp6xe9JJHMcrPKq4,523 -awscli/examples/apigateway/get-method-response.rst,sha256=_nITZb-ebXR2X84-Ms_u83H1TFEj8dqx_WCgJfHCqNk,359 -awscli/examples/apigateway/update-integration.rst,sha256=S9aHQClfSlQRaogfed3A8Y7EzREskp7h_8snsvY-Frk,1171 -awscli/examples/apigateway/update-method-response.rst,sha256=ainS2VHZx9Y3u9hs1VFO1ksiGpY3mKOptWMaEQ6oZmA,627 -awscli/examples/apigateway/delete-api-key.rst,sha256=_dz6OS0bJeU1wGzfKtBmetwX1k4ybxFM1xgWaoXFqz4,120 -awscli/examples/apigateway/flush-stage-authorizers-cache.rst,sha256=x2geDlHXHBllGSEU9AHiRReV62Yh1DMgEXqYnfPIuKQ,154 -awscli/examples/apigateway/update-domain-name.rst,sha256=Phi_xMfG9YLUIOFwZIhHRUjQmpdjmP2lysz8cjOrMgo,432 -awscli/examples/apigateway/delete-stage.rst,sha256=W8-ygGT2gLp_65vsXD8ufK7cnX9S_3-7xvVD2roEnoI,118 -awscli/examples/apigateway/put-integration.rst,sha256=k8IaFa6qSMnFauk4ceCn1Eyn8ElpsJwSRWJYyhdn2NI,826 -awscli/examples/apigateway/get-usage-plan-key.rst,sha256=t2HABv-P3f_O2ii8jyYwSuj9uRQYvX0k3g-8vZCLweo,187 -awscli/examples/apigateway/delete-model.rst,sha256=pMlQtCQa7thRV0KuGuq1n-vjFT4ll49tsQR2cO_jGsU,133 -awscli/examples/apigateway/delete-rest-api.rst,sha256=XtNu9ItEcHp_VG9rhMka_VOIhkcMHTny3y8tzWOSkBM,91 -awscli/examples/apigateway/get-resources.rst,sha256=0tmfEkrtFfXDSysKkrzVTGD32ap9CjS091zkZUGB6uw,420 -awscli/examples/apigateway/create-stage.rst,sha256=hGuEZT8mPPv53COh53ocCPG0_p7QaxAiFrmOXBupKAo,508 -awscli/examples/apigateway/update-method.rst,sha256=3-cdeEiZWXjbmKr1X02MUYXAmUUSP1xAJWV2aWKoHnw,454 -awscli/examples/apigateway/get-authorizers.rst,sha256=rI0GLfS1j8xJRRNWh6W3zHsvsSIIEAWabL0FSVjSy34,591 -awscli/examples/apigateway/flush-stage-cache.rst,sha256=uqV-8Nk-ziNpU1COQ9Ya4Z0SnqYrebT5Pz2_mofd5Lk,131 -awscli/examples/apigateway/get-stages.rst,sha256=-zqrTMHluYHSx6_eYWsnsfjvRnZH_P_MlV_TUGXIXb0,995 -awscli/examples/apigateway/get-usage-plan.rst,sha256=PC51MB7lxh7g6YrQqi8SDLxnHjgzF_Mf1dAv6U8aAU4,106 -awscli/examples/apigateway/get-domain-name.rst,sha256=vjepcVI7Vex4A3QzFxVSZj4-nADyFhZ6qPRVrYIctp8,338 -awscli/examples/apigateway/create-domain-name.rst,sha256=e3F0H75iyDs7o2OY585U4n9flrmbkMKhHq0QnChMo04,259 -awscli/examples/apigateway/update-deployment.rst,sha256=F0QGM0_Q9NdxAsNIsS8SU6AigvjiW6tj8VhqLZ19n6A,331 -awscli/examples/apigateway/delete-integration.rst,sha256=d7jjFudpuWKiobH-o3jO-4RqvVEj3-uZ6-1vZC0t7fk,183 -awscli/examples/apigateway/get-rest-apis.rst,sha256=I3EAQuSRG9A4vSsCJ89LG6NZPxEPrVb1CPmjGk4Zqf4,256 -awscli/examples/apigateway/get-sdk.rst,sha256=eikTrolR5kTQwAMb29BUIPOWBL-xr9NpzuMmMknJTIM,1156 -awscli/examples/apigateway/update-base-path-mapping.rst,sha256=tlYXrUMMD1SzG88RySyR6W4ipUmxum-1IIPUPkzDB7A,312 -awscli/examples/apigateway/update-client-certificate.rst,sha256=WrQL3nePmhHdmDIsdiGYIha0eC3Al9TL4PN1fM9Kssg,219 -awscli/examples/apigateway/create-usage-plan-key.rst,sha256=TSIMqsMcVfoX2CHDtaHoMMPCBnIFphCcNjXKkH_GKA8,167 -awscli/examples/apigateway/put-rest-api.rst,sha256=DVmwRZk752dZfNp5Mw0NQ_so1VKIpSOa2EFiLMDgN70,378 -awscli/examples/apigateway/update-authorizer.rst,sha256=_busqG4-P3arZvf9gPhVUxtGQ-p_Qf26gBjQfkK3VHc,1382 -awscli/examples/apigateway/get-integration.rst,sha256=4Y2-VXhWCAJHBia-FSKdFyYHu2ahRAoX7fel6O5Ozqg,696 -awscli/examples/apigateway/get-usage.rst,sha256=sly9in4bJXFSfWYkzhjWIIuR2gy09Mqu-GwaUoPJOgE,158 -awscli/examples/apigateway/test-invoke-authorizer.rst,sha256=ZzPohdJUR0yHs7QaMyChSZXBKxYDRiWcXV28hZRPfe0,224 -awscli/examples/apigateway/update-integration-response.rst,sha256=V8ckCAyWu194DKVy-3I5Qa7UACBtqmS4_PcvQgOjKjk,794 -awscli/examples/apigateway/delete-domain-name.rst,sha256=zsSM-UwTbN_cbpxNo1aJb9S3o6RdkzT-FZvxx31vXH0,114 -awscli/examples/apigateway/create-base-path-mapping.rst,sha256=-kIRisT9ZpLGq3uDVcA4gFJ1_inCsLt2RygiGz6vVE4,203 -awscli/examples/apigateway/get-deployments.rst,sha256=613M91R_Q-Pq9hkhpmAiZ3eesGpYdnRKDm7KHZzEgrY,326 -awscli/examples/apigateway/get-client-certificates.rst,sha256=tXvCkw9U0vojVgicn37IfTIK4wxPtFIpf3casFjd6J0,470 -awscli/examples/apigateway/create-model.rst,sha256=YdySmCiq4jBTLTQn40GfttR10RXNb0IOpTUXv_Vy7uI,804 -awscli/examples/apigateway/put-integration-response.rst,sha256=iQ-QIcziAwq6FUnIVibNCBMsoMiQICgcZt2kpNzuwdw,673 -awscli/examples/apigateway/delete-base-path-mapping.rst,sha256=BwX-C_3gicZswKc_iL2mXiF86Xe_BFaEkvSR1SIfkVQ,162 -awscli/examples/apigateway/get-export.rst,sha256=y17CLlXEoUzSPOFc0fU6KfxzFAmNsNjHS88wxxqSKGs,650 -awscli/examples/apigateway/get-account.rst,sha256=crfNjpzAlHzPFOyEvlLgo5qZk02iJoJTgLyNW4Chtng,289 -awscli/examples/apigateway/delete-authorizer.rst,sha256=rRnhQpPcBFRQquYh3veihLnkUJCemjxW1wdxlQtdrig,139 -awscli/examples/apigateway/get-usage-plans.rst,sha256=yetUBDq-iyYNOUl8K_3yuI0CaWmcnTu_ijr32vDuQvk,87 -awscli/examples/apigateway/get-base-path-mapping.rst,sha256=96hWpBz0JygCXkurjLrAM8WFFeK99R1EDgzU_iF_wRc,258 -awscli/examples/apigateway/update-stage.rst,sha256=3MswVHxBoP9gg0NTvsBSpyK0jPvLqZol8zQYcVmEk7o,545 -awscli/examples/apigateway/create-api-key.rst,sha256=631sPtUi7lgga18sFdvoUk-f6dSYhhO_KROtDUQnCM8,235 -awscli/examples/apigateway/delete-integration-response.rst,sha256=nq71k0va3X0OMHZKejXoMzBerfWx_waqOYQY2P3YiEE,233 -awscli/examples/apigateway/get-authorizer.rst,sha256=p3rQE7KT3A7TcS6UAZcffhEqM5ySvuP-Oywy3fjml5E,518 -awscli/examples/apigateway/get-deployment.rst,sha256=V7p0C7wGkLe3zOvgOWcfGbHYwbeYXwime6a94-9NECQ,244 -awscli/examples/apigateway/delete-resource.rst,sha256=AenfFGM0aM8HMMjBuefY3h16sJiys9cOuCpobLJLrLs,126 -awscli/examples/apigateway/get-base-path-mappings.rst,sha256=ktV0hDpF2ZN1c6lVuEdWPyW4Vlg_kIVNAV79-Yul0Pk,452 -awscli/examples/apigateway/generate-client-certificate.rst,sha256=uilz_xs0R3wTitY0zwPrhGBnXuTIrvDrQAn8YpnnVNU,145 -awscli/examples/apigateway/update-usage-plan.rst,sha256=cijkXpPINYBupBWlC5WCsqM2HbZSkcq0IKiEwOEA0HM,783 -awscli/examples/apigateway/update-model.rst,sha256=gpgEEAxuba4Nz5zeobfHbyUIDsj5H4zBgOaIKoPG6ng,513 -awscli/examples/apigateway/get-usage-plan-keys.rst,sha256=uflr1n7ovvP1aBb5aKfGGbRu8OwYrY_oneAxZHAjZWo,133 -awscli/examples/apigateway/delete-client-certificate.rst,sha256=xaqSCQAgV_LkVOHD2PxoKp_0BOl99HMjvLtyh3RQItI,121 -awscli/examples/apigateway/create-resource.rst,sha256=PqxSPtwKQjp2UeKl-7Tuide8HSoaVKMdByaeyw-vZVo,151 -awscli/examples/apigateway/update-resource.rst,sha256=uPwdlNH_f2vgaSLwjzLPtRy5YfIf5RBibFYRzH0Qn2c,706 -awscli/examples/apigateway/test-invoke-method.rst,sha256=WPS8b6WN9mLJMrAZxfBJFwmJLZDY3EV9I278gNSY3fU,470 -awscli/examples/apigateway/import-rest-api.rst,sha256=-PdFJpWRIoHcTbgZEz__kJ-vuCmdkSdwzHF1CmNYSqA,147 -awscli/examples/apigateway/put-method.rst,sha256=RFhgMBN0u5_hZy069HXeQUkASdDNJ0V8iOfoQnNQ29M,337 -awscli/examples/apigateway/get-client-certificate.rst,sha256=vDTA_vsIDDXDz4ZhQKK7geOTnGGXML1I3od4-v8l2Ck,115 -awscli/examples/apigateway/get-integration-response.rst,sha256=1nwegleU3yXr3F0gjESHTV8SwxAPD5ZEL5TITcViPGc,360 -awscli/examples/apigateway/update-account.rst,sha256=Lq8ycj0aOfPAN0nH6T1EK44LMaxtz2j4dKrlD7NIjys,435 -awscli/examples/apigateway/delete-method.rst,sha256=LxYVw1-Nd5VC1g_u1ZCyg9GQueO8JQSImvrg8GeLBqU,163 -awscli/examples/apigateway/delete-method-response.rst,sha256=YnGlWK-X1ri-dhn5pBql0-QB9NXPSiT7HHqytz5WF2U,224 -awscli/examples/apigateway/create-rest-api.rst,sha256=nmzAIZWf0h9pYpTYTkpMO9fxOB50WSfQp5FPSD90Guo,323 -awscli/examples/apigateway/get-models.rst,sha256=MgqOgW6kwf0SnttXR0e1kiRFeCSUpX_euZQJOhZh3yg,942 -awscli/examples/apigateway/update-usage.rst,sha256=s1MKpgCtjGT1xM95xvmxrl4lcFbTzr8JXp-0R7nLxM0,275 -awscli/examples/apigateway/update-api-key.rst,sha256=X-Svw7YJ9BD1NuViVf93XIFAi2Zbw_lihw0SXkW8V8Y,983 -awscli/examples/apigateway/get-rest-api.rst,sha256=lrxLyLiCRUURkExeOSd4p4WmLjsw0LCr3fqVX1OVcZE,205 -awscli/examples/apigateway/update-rest-api.rst,sha256=Di1enXd0UIj9R28LTMrAk4avpLLVpv0q1OebmU8H-qA,344 -awscli/examples/apigateway/create-authorizer.rst,sha256=1CwJcYANbaigq7Wr2W_y9YJJ0EGwYHotdcusDbnuWds,1583 -awscli/examples/apigateway/put-method-response.rst,sha256=G9ABN6h89ARvT3mnfXTmTQijgMOM7NQrpfQbt3qBee0,299 -awscli/examples/apigateway/get-resource.rst,sha256=cL-wqy0onOnG1lA7PcKlYnwhcLz5V1pBbK6K4uEWh2s,252 -awscli/examples/apigateway/get-stage.rst,sha256=P8tIcDmhcT7aa0Dn4U9y3SjZ1_2NpG3_jBVr1mqx7l4,1466 -awscli/examples/apigateway/delete-usage-plan-key.rst,sha256=s5dwTgfpZlzYKgIUNiBvcwPC6Q2l_YNwlniXf_xzg44,167 -awscli/examples/apigateway/delete-deployment.rst,sha256=p18PJ5pGWkFYeOjlwfLZ2KTNuAIB9xKjZPsaWZYiYrc,132 -awscli/examples/apigateway/delete-usage-plan.rst,sha256=BJokdNDCmJSzap414eGEbKSBkhb_XkIMnzLe0blHw_w,97 -awscli/examples/apigateway/create-usage-plan.rst,sha256=625rg6750Q5xttJ84O6mtzgeIAasVtq0JulqolsoWK4,281 -awscli/examples/apigateway/create-deployment.rst,sha256=dBI2w2yTB4xvnnNMCPFBIgk_uPj2SEwElgeSTsAp1Vk,724 -awscli/examples/apigateway/get-api-key.rst,sha256=tFCIrH1DtTLfzUk1cHuQ9s4mE78esyMThqR5UuZR_U0,464 -awscli/examples/apigateway/get-method.rst,sha256=F90q7uGHTzo3cK4DsgOFTUznb73iYP8ejZ3OGN0G6E8,1112 -awscli/examples/workdocs/create-custom-metadata.rst,sha256=gfOoaeRhD5W2GQGF1ceEWIqXrt0xq7WWrwaTAiIw_tU,305 -awscli/examples/workdocs/describe-resource-permissions.rst,sha256=ylhNua8hmTeLrD1mTaNiAKwMpqd_my69BgOS-I42W4Y,1119 -awscli/examples/workdocs/activate-user.rst,sha256=DOknK-K4OkwEaXBkpfLrHQlNYCz7bDgpHjAGlp97di8,1057 -awscli/examples/workdocs/get-document.rst,sha256=KUMzc_Sp2h4wbvXvJaJRo5VFg1x1Z3i6LUG5Vf6Zoso,1260 -awscli/examples/workdocs/describe-activities.rst,sha256=8LoTTUeg2Wa65E5QqvT2C-TPT3-7fmZ0FiO9rQ58bAQ,1912 -awscli/examples/workdocs/delete-document.rst,sha256=W62DXQirMMOh2gfxgQcXe1ddZfWIcz9oHdE3nU3qD3U,220 -awscli/examples/workdocs/update-user.rst,sha256=mUhXWsDuG68R6LmCjwrmuudqq91usYUpjEjhlmsyeAo,1066 -awscli/examples/workdocs/delete-user.rst,sha256=ao4EytHxjLCXrxTE6C3Y-zT8E2_yIy2H-yTZmBOSps4,189 -awscli/examples/workdocs/add-resource-permissions.rst,sha256=dkn-MhDs3Qa8HKZT4ZNZSGDwMaRh9mzb2d-fGA_mA64,611 -awscli/examples/workdocs/update-document-version.rst,sha256=xdks06WTzMX5WhfGz6X5B1fkv-X9rQKslxjo9mdwsQI,391 -awscli/examples/workdocs/delete-comment.rst,sha256=vpOLOH4SsKLsQWygekt8VfwiwKjSUgKhSOlyvuVmT3I,471 -awscli/examples/workdocs/describe-folder-contents.rst,sha256=8Wcy78DoCXNNiGZ8KnGo7KfKWQ3nE_ksQTH__HgjbY0,2119 -awscli/examples/workdocs/delete-folder.rst,sha256=0G-FI-FN7Dhlgry63rT4940vHo86YiX2QK08XHzJCEc,212 -awscli/examples/workdocs/get-document-version.rst,sha256=QMumRpuNZ3dp01BiRMkp5O6YbGYK_Hwu8yg0m8vi8DA,1618 -awscli/examples/workdocs/remove-resource-permission.rst,sha256=Te22niXhPgPYCkpAfwch_Cld7fsRKg-WtZ6idZhNoJk,308 -awscli/examples/workdocs/remove-all-resource-permissions.rst,sha256=YvGhwhcxCxYDT1iJoPehKFSScHuFy7C3MyHdlkdjR8E,288 -awscli/examples/workdocs/get-folder.rst,sha256=aZvikb9ws8Axcy0g4EY304W4dA86aKR8S6wHvfIPF30,817 -awscli/examples/workdocs/describe-comments.rst,sha256=txwUah4eZjBJy9KJByIHAXuv15mRpZ8LANkgtkkXLKk,960 -awscli/examples/workdocs/describe-users.rst,sha256=Y6DEeTjA9Z98YJW-ptlw1QFH1mt7Tpdg7x50TcxmVeo,1511 -awscli/examples/workdocs/create-comment.rst,sha256=7oE1kR1ie8aQc938f6szn9GGyx1hqVU127qod39pHps,987 -awscli/examples/workdocs/create-user.rst,sha256=aipYOUO_5Q0YMXBBK45DXoGpNBQRNXnt7scBMB_BwFM,1214 -awscli/examples/workdocs/get-document-path.rst,sha256=mKQmDqzOXq1lw89wpBlQc1bHjiEN0hW0eTtJdJdcgSI,904 -awscli/examples/workdocs/get-folder-path.rst,sha256=gcca3HaJu1gxcaHfvdofkuiUHX2-lifmd8ldfQucETk,898 -awscli/examples/workdocs/delete-custom-metadata.rst,sha256=bCo_OIrs5i9v-WHOY9gdA_szQojfq16HjS1_T4y5Zuc,286 -awscli/examples/workdocs/create-labels.rst,sha256=B6-zhGiuRpSblHvSeyZQWOnMSm4XhWDAUD3Gzx7Qr-I,272 -awscli/examples/workdocs/update-document.rst,sha256=OQWRymhnLUxUZmLRGICeF96u-Hu5KWgfcG1qK8Lk8bs,335 -awscli/examples/workdocs/update-folder.rst,sha256=yWh-4K5dvnaLcX5YPdrQsHCGqpBEp0njW4uB164sQ0c,331 -awscli/examples/workdocs/describe-document-versions.rst,sha256=X-jw86JuhSawmSoiSHCwTHQruy-L9nS4VDY-3NjfkjI,2754 -awscli/examples/workdocs/initiate-document-version-upload.rst,sha256=6eW2VUraXdltRXFSr6sqWxPRFPWUNKVZoZUMDRmNG1Q,1914 -awscli/examples/workdocs/delete-labels.rst,sha256=2kMkd3yMpBTRsD3C6JQIsF2Xtpplw08uSjScuw5Z7UE,260 -awscli/examples/workdocs/delete-folder-contents.rst,sha256=kHoDMEBDik17t8-yCNcuDU1vyrAclM9pdAf5JINIwXg,253 -awscli/examples/workdocs/abort-document-version-upload.rst,sha256=UEOxz4HKTxoJeIejuEOvNBPed25Y9ISYfmZNih4hhUU,361 -awscli/examples/workdocs/deactivate-user.rst,sha256=n6gtiDIxST9dWjAULwJzPoV7J1cQCSxBsrn-zncV1H8,209 -awscli/examples/workdocs/create-folder.rst,sha256=5fW3UOd7jPLRpJ1cecu5zkARY_AZQNRrmPR80RevmrU,750 -awscli/examples/dms/describe-connections.rst,sha256=0k2Y7qNF3gGeGbfrsBQo--xNyQdXSfui3QxYLs6yHYM,625 -awscli/examples/dms/describe-endpoints.rst,sha256=ELH8VMlLsM0-H18gQPH6mlsx0SxzAuSvmqSSAkoFYto,1093 -awscli/examples/dms/create-endpoint.rst,sha256=xWxoWKja_pxnndtv9pFIJpe6bSlYbPZ80_1H7Lu4C78,839 -awscli/examples/dms/create-replication-task.rst,sha256=qPOTdRZnn9CuXPZgq3IjnP8-c4oc3htSdBD_yhLV2OI,2789 -awscli/examples/dms/create-replication-instance.rst,sha256=Qjb3BtVLcy2GN10Vb79Gu4MSI1SypphmHZwDaxQ6A7A,1860 -awscli/examples/batch/describe-job-queues.rst,sha256=O7uzJ4uqUwTdCvb3t66Sst9z9VZohxnsRIB4xOwVncE,737 -awscli/examples/batch/describe-job-definitions.rst,sha256=y-bt7jot-XYjAzt2qxNm_9wdtc8AT0H5rFiB37QuO-E,925 -awscli/examples/batch/create-job-queue.rst,sha256=Lt80RzWbOnNGTZ_ErGcnMZpd3YU5IifwlTann8cVcGc,1521 -awscli/examples/batch/update-compute-environment.rst,sha256=viftGlfUbxzE2S5tmmVqYZr4ncdN1uS6BYJzn33DDak,381 -awscli/examples/batch/submit-job.rst,sha256=H7-sFhoAalC_oLi5lwR0gNtSbC6p_hL-Q3e6LmQe2-U,321 -awscli/examples/batch/update-job-queue.rst,sha256=lCWNs4m-ibmi6VCCMr4_9QJe7itglZ9vjKCr6y4K9pA,285 -awscli/examples/batch/describe-jobs.rst,sha256=TUWqq0TrDKjiWaU1GMqIPym3sermqmekIy5Itbunw6k,968 -awscli/examples/batch/register-job-definition.rst,sha256=CGlUXd-4VPFOxp1GAz9gqLFg7uIOxcLLK4BYGiZKb-Y,468 -awscli/examples/batch/describe-compute-environments.rst,sha256=ei1cS5eJhw_wbtrBJb8VaGX7lUfKnCLbfiPdTrKZr8g,1522 -awscli/examples/batch/delete-job-queue.rst,sha256=FE0oNe2sujadyXRmn4G189SekTx8qZxAJ4B5Gi3aiJo,128 -awscli/examples/batch/deregister-job-definition.rst,sha256=Hcy4HFeCUOpw3oh9ds408B0L1C8dHxCf-TjiLJ_P0hU,170 -awscli/examples/batch/cancel-job.rst,sha256=Y597wZZ9YeDiMbbf1mMaeSbbSbWcXbN-nKCgG7KW2oY,183 -awscli/examples/batch/list-jobs.rst,sha256=zHubpZyKI4j1lNQb7blXW-J-W55HhpC2e2n2fD8vNuQ,714 -awscli/examples/batch/terminate-job.rst,sha256=EsfE1ZcllyiNj1IgDku8ban3btq8Lwv8MMssSl-qp5I,193 -awscli/examples/batch/delete-compute-environment.rst,sha256=u-DyGTp3Tq3RtAbUNCxeNOQBvzfFisfYHok8MvifJu0,180 -awscli/examples/batch/create-compute-environment.rst,sha256=EGbprlaj8zHS4B7i3uV4gugDJVaiSbXlfTiDmvIAP9U,2607 -awscli/examples/autoscaling/create-auto-scaling-group.rst,sha256=mezXqotBSWYOgxClDmeOip9w-MxLln7kL4U-Yccx4Us,1585 -awscli/examples/autoscaling/describe-scaling-process-types.rst,sha256=BEFaVpkPUIk-xYX17hsQ_GzndNBx9Zc_eO1y8eHzMC0,1087 -awscli/examples/autoscaling/set-desired-capacity.rst,sha256=X_LA7h0f0zQpDL4payXE-TrC6FpH93il8dEfJvnjuY8,265 -awscli/examples/autoscaling/detach-load-balancers.rst,sha256=ggdPkiUT2_XE3fRNpAys6P1J9rkH41Ofupzqr90P1aY,278 -awscli/examples/autoscaling/describe-lifecycle-hooks.rst,sha256=m6vmp7qGyHtZCU4U7F077UAd-MpF08xP94j_ON98INU,828 -awscli/examples/autoscaling/describe-notification-configurations.rst,sha256=zBC_CTSpxHQvD5J8YWQGeAsJn-YZTBsbfHsRXNOxXC4,1995 -awscli/examples/autoscaling/describe-termination-policy-types.rst,sha256=jLGAkzn_6bu4FNhmIlZqP28dTaKuP5fw0Y2bZMQefco,762 -awscli/examples/autoscaling/describe-policies.rst,sha256=pv1vNWs5OIuid5K3Ug-I-ONnY76hHPqHAR-AU2vPy14,2702 -awscli/examples/autoscaling/describe-metric-collection-types.rst,sha256=7RnXVy4osjDF2rhaDKX6cnKbV2dFXoTon6hVxlKojQo,1228 -awscli/examples/autoscaling/attach-load-balancers.rst,sha256=lZ86UX8Du8tosgQLT-sNyz5JwfGp-umAe_eCkvd0caQ,274 -awscli/examples/autoscaling/detach-load-balancer-target-groups.rst,sha256=RCDW0kj6ZotYg-jHsJ3NtpJjXVxkWqit8vf0ydd2vec,362 -awscli/examples/autoscaling/detach-instances.rst,sha256=oGSRMCA0ddjMNis-ZmolcsYxo179rbYA9dmI-uc3Ijk,949 -awscli/examples/autoscaling/set-instance-health.rst,sha256=TYFHfF6FD8DaKjSVnLZhzXSd_LgCt4DwKa1bziiqH3s,218 -awscli/examples/autoscaling/execute-policy.rst,sha256=JNBwXFrngmGhKaBoCT3qwlKLbAH0MhV1ErHB02Gsx3o,457 -awscli/examples/autoscaling/describe-auto-scaling-instances.rst,sha256=2lM36y6JntrA2nzducqXYBc_EViXBjMaZ29CPSSkXh8,1623 -awscli/examples/autoscaling/disable-metrics-collection.rst,sha256=GczQgIY1_0D6BTZYhjvXWf_1gKNoDNZeRQf2mK79HYk,571 -awscli/examples/autoscaling/delete-launch-configuration.rst,sha256=VyrCov3_1Wdc80GQ_lEXVOT8JZVabY1DyG8cu7tcoTE,419 -awscli/examples/autoscaling/put-lifecycle-hook.rst,sha256=h6XyKGuIyREd_yjYOyJD-8jO64IBzRY4uTH3OBtimbM,607 -awscli/examples/autoscaling/delete-auto-scaling-group.rst,sha256=eduZ1lLqFV2tJOLd9cKPofz5u7v_gva-HnM5MRYJsac,661 -awscli/examples/autoscaling/describe-account-limits.rst,sha256=UY3k8YcQTht6bKUKN8nhPOh1_TuDJIaxB5JuZHPsTUc,588 -awscli/examples/autoscaling/describe-auto-scaling-notification-types.rst,sha256=XSNQLY7mKs7fYYd0kGyz_2ga27FY6PFs69jefzSQjaA,826 -awscli/examples/autoscaling/put-scheduled-update-group-action.rst,sha256=3BCp0OSbkzZvoZD0Bg--UwL6lpx9olHSUewm6zW8xsQ,983 -awscli/examples/autoscaling/describe-tags.rst,sha256=mK9Vf4DDiWx19EUjhAbh99bGzL0tU4qVoSOYypszkls,1818 -awscli/examples/autoscaling/describe-auto-scaling-groups.rst,sha256=sMVqSDnG2Yh96ujSkKKig1n1EBxLQB78dWLfZd4asLI,2164 -awscli/examples/autoscaling/describe-adjustment-types.rst,sha256=yuP_qAcNxbztaM22SZcg7PFCdOZ4KvRMoH_McaJqBVQ,729 -awscli/examples/autoscaling/record-lifecycle-action-heartbeat.rst,sha256=c2JRww62Sxh23dPpOIAk9a9V8nrgFyrOPuUsauxRYZQ,341 -awscli/examples/autoscaling/exit-standby.rst,sha256=EhtuPRk41ZQfAS5gcN5wxJepvK1ssuJlHobDeWtwX8g,904 -awscli/examples/autoscaling/put-scaling-policy.rst,sha256=plaFl-1olnGQ9AEtEqfbSiDsagZBQdrAee2FalWl9Qw,1317 -awscli/examples/autoscaling/delete-policy.rst,sha256=NGedkQLwSG6kMAgsc_ZBkobZgzaWHrDXfw3WJpLC3l0,200 -awscli/examples/autoscaling/update-auto-scaling-group.rst,sha256=2U9OxJYIUdwsLxnHhGIJRkL5b1EriiHFcsk3-SrS0HE,1428 -awscli/examples/autoscaling/put-notification-configuration.rst,sha256=irs96MaGb6g3VpnBTSRHKY4pQrUDRN0q77LURwah3A4,637 -awscli/examples/autoscaling/delete-scheduled-action.rst,sha256=YrGmYt0Kk6UwikKONGZXbsu0jzFVJP9mVENdvq4ERiM,290 -awscli/examples/autoscaling/delete-tags.rst,sha256=h0u6NQcvLnxhJQ59-ilxi5OJRycE1WhIBDbwCgBmZSk,493 -awscli/examples/autoscaling/attach-load-balancer-target-groups.rst,sha256=hwQZ0s6FPHwXd42V0R-sTJEFjPQrNwtukp0QYVi6Zdc,358 -awscli/examples/autoscaling/enter-standby.rst,sha256=ehnYsHH7eaVWEmCDMN90QlLA5aaroLb_v14ct4r113o,925 -awscli/examples/autoscaling/create-or-update-tags.rst,sha256=RMC5Qyj2vL_Kucl3pXB-rUrQnpqRQRuQp-MYkYckVWo,396 -awscli/examples/autoscaling/terminate-instance-in-auto-scaling-group.rst,sha256=CRQEq91LD-tquzQlOL649JQMvvpy4fUDKU4vSfDwCqY,394 -awscli/examples/autoscaling/delete-lifecycle-hook.rst,sha256=gBWqazLJvusS28wZ-3ODbIUh558XgMxyJn_dfoItA9Q,215 -awscli/examples/autoscaling/suspend-processes.rst,sha256=YMG-WzDpxNb9YxIMhfI9su7Xa3KDzMK0cpglpMq4XTU,499 -awscli/examples/autoscaling/describe-scheduled-actions.rst,sha256=Q1OOiSaDt7H3lc3pvhAN4WfgwoAeLf2k-i923ltkUTs,3036 -awscli/examples/autoscaling/set-instance-protection.rst,sha256=9aenV096SH2_Vl3qJ_mOitga7mMn7c5eYt1k52iY6iE,498 -awscli/examples/autoscaling/describe-lifecycle-hook-types.rst,sha256=erOU97RS2Exb9HXbwZCL3GGXz4yDKP3BTadR6zf5-mY,358 -awscli/examples/autoscaling/describe-load-balancer-target-groups.rst,sha256=YPPmLoPN4CZ1hePx-GgCHrO1fNA_9DO2w6KqGyxjbTg,525 -awscli/examples/autoscaling/describe-scaling-activities.rst,sha256=TPqGBeyvH6RwfeNvDdWRkvkYZzcG1Q7CsmDttFg4MJ0,1728 -awscli/examples/autoscaling/describe-launch-configurations.rst,sha256=3RDaDahL3LH5rmjrRenCc_Hjld_ZDhig6MR0Xn4x9qw,2650 -awscli/examples/autoscaling/complete-lifecycle-action.rst,sha256=PlJG4ir9BvQ69IOjsEqYM5UTijJCHTjqtusLY10xdSQ,415 -awscli/examples/autoscaling/resume-processes.rst,sha256=WSwsX9CFJRNHt0k5z_-aOVejyopR1OKeT6K00NUKHU0,506 -awscli/examples/autoscaling/attach-instances.rst,sha256=fu1aroKswBLmAJICNPDmykSWiJBxat2QBEkaXcCJoFs,247 -awscli/examples/autoscaling/create-launch-configuration.rst,sha256=iMVzpnS7eHG-sczf6i8XVk6StzOcAKYAmViMrt3uzYE,2013 -awscli/examples/autoscaling/describe-load-balancers.rst,sha256=4PbkGM9OEfVPNmbK7W_i6v6JO8640AIilocYxy8FpYE,438 -awscli/examples/autoscaling/delete-notification-configuration.rst,sha256=_Xv0tX6RypjOFuD0Tcrn0WXNJbSH48IdONRqn2Ex5Hc,567 -awscli/examples/autoscaling/enable-metrics-collection.rst,sha256=QKcEOsWrB1fQjPCYkXlBfoyBW3YiE2T6gUZL8TDXTRs,743 -awscli/examples/eks/delete-cluster.rst,sha256=F_eqdpPYUJDCxqdkjCZ_kvey-j2n6HYQFRJQdXIqy84,152 -awscli/examples/eks/create-cluster.rst,sha256=C5TXuPgtxbtry2l1wYliOe5O8zVX75OXcFWlzjYQ_yA,1067 -awscli/examples/eks/list-clusters.rst,sha256=by0aD_Ee5Aa8MR6rIXRj8HQEQBoYGn353RdW32N4P_k,250 -awscli/examples/eks/describe-cluster.rst,sha256=Y1pBGs43_Xj3Yl6rKqyB5vf59NyeI2LeQOniwU0fhHU,2400 -awscli/examples/eks/update-kubeconfig/_description.rst,sha256=hRuVsOd7NBbKOtKOK_2xehi_TlG1e1qoXsqSO6XkI7I,1789 -awscli/examples/s3api/put-object-acl.rst,sha256=i-ymKAtbaQmgqaIXtxG_vh2yzEkqxfJJRboCFHE_2k0,554 -awscli/examples/s3api/head-object.rst,sha256=tmc5LRqZGa6atv5OsgcPoMCRBYi-GUmtbKHpQfU7BpU,417 -awscli/examples/s3api/get-bucket-replication.rst,sha256=u6hdXFoKr3uUjDpRYAorkUrKDhPMgDvl82H23wC8auM,667 -awscli/examples/s3api/head-bucket.rst,sha256=1gj5CxrT7AXz5Fxd-c2vTXPxJ0Ku3usVINpytShBB08,326 -awscli/examples/s3api/get-bucket-location.rst,sha256=0poZpRxgW8ZgijMMOFC6BEjmy-AbHhLXzH51wY3tYBg,225 -awscli/examples/s3api/delete-bucket-tagging.rst,sha256=mUstWEDIMDUZyDUQY05hmxu8dcbdYPwgXXfNCOiyYSI,144 -awscli/examples/s3api/put-bucket-versioning.rst,sha256=pVqHVVYs__xnhyR10G0D2KJfPFkBFLbW6IUwUCF1m6U,356 -awscli/examples/s3api/list-multipart-uploads.rst,sha256=ocCQf4XTX32xNq05z7KgkEsDXRB6_5qEs_bOaHcJmYQ,1035 -awscli/examples/s3api/create-multipart-upload.rst,sha256=qa426KP-Zh1kGJHQa5o-KcEf452yJJ5c4iSrclBDeBY,596 -awscli/examples/s3api/get-bucket-notification-configuration.rst,sha256=0WdlPw0JW8NTncXzLHv0ugCkhM-zchjmkTOAcOp9dvM,489 -awscli/examples/s3api/abort-multipart-upload.rst,sha256=5XvMeres9Tw-dsNTvFhtzDaLVKwRs8MnICwBgKTUd0I,463 -awscli/examples/s3api/put-bucket-lifecycle-configuration.rst,sha256=Ul1x6MKcRQYypYEvK6AcVamWWHe8pswIAouvThWs-zo,1405 -awscli/examples/s3api/upload-part.rst,sha256=KKygxVqybCubtz_Cvaiy4oMIZZcUqbtaYqj7xwWfdug,845 -awscli/examples/s3api/put-bucket-notification-configuration.rst,sha256=SeG9hDZXkEVBIcYm1SsDjxJKuJjExUvTYMcclTVRSR8,1109 -awscli/examples/s3api/get-bucket-website.rst,sha256=9qyBnfA4V07Zy0bYapKpF8YI8MPIBstA2eUmzk2NZbA,300 -awscli/examples/s3api/put-bucket-acl.rst,sha256=4AyAdWMvfRfb1Tmj_M7lPTn7AM_7WxYEr3RU4FvtF7k,531 -awscli/examples/s3api/put-bucket-cors.rst,sha256=JQfwK5WM9HCHB2mJTfx0StH-lz00SddmjW3gFlWMpZI,701 -awscli/examples/s3api/put-bucket-replication.rst,sha256=ZukTqGQbO5WWLJmeWEwtgrwRk7EkcyCsCEqyc74gmAY,1247 -awscli/examples/s3api/put-bucket-policy.rst,sha256=Trk8L-f4Hx3gjk3rRY8o3sd27e8a7sH4jp3Jn1daGYE,1007 -awscli/examples/s3api/get-bucket-acl.rst,sha256=DvKyE26vRZbFWifqqWDSv4a5T0a6r0II-U2rTpMgex8,582 -awscli/examples/s3api/get-bucket-versioning.rst,sha256=j54UIj4TG4igp_jhgAUDsE_YTkl-HghU9R3vbmdaSNM,195 -awscli/examples/s3api/get-object-torrent.rst,sha256=XeB8gOObz6asI-m3YkKcARBaWNmtMRGmyqzOE1UL-KQ,391 -awscli/examples/s3api/delete-bucket-lifecycle.rst,sha256=Z63HsOGpG-yJjX6iialtJNjYaU0_dkgiD0KqsKxdT7M,148 -awscli/examples/s3api/delete-bucket-replication.rst,sha256=2dLYEq1X-cskYVVMVUGK3Ho653upyLeKrmj150xTP78,152 -awscli/examples/s3api/list-objects.rst,sha256=r8DVjrowfqpfr29c0mbSDnaKXumBcJ7WvhNqDxRuEe0,560 -awscli/examples/s3api/get-object-acl.rst,sha256=YE7REVPRSjiCOPahV6LsXCMQtW_rAf3MMRg_ZLtYAyg,790 -awscli/examples/s3api/get-bucket-tagging.rst,sha256=tFmL2fSrF0ycywPdQCRdudrO52IxnLNqXzLY8f-IRNI,285 -awscli/examples/s3api/get-bucket-cors.rst,sha256=xdyfmJzoH5TSdEuc6j4VFMTCJJEL4yJNmCzcwe7J6cI,960 -awscli/examples/s3api/delete-objects.rst,sha256=MzTHW-u7YM2IapljTeJsJwsLCX49maMZvtDO3wkHsmY,558 -awscli/examples/s3api/get-bucket-policy.rst,sha256=bG4YZXpawQsffXkTTuKWgIOZ5MHJ6D0klTWGAZQyJVc,1075 -awscli/examples/s3api/list-parts.rst,sha256=97OcXRAFut73iqcmlytBPr_kI40SqgUJaSE1V6AbnRo,1327 -awscli/examples/s3api/delete-object.rst,sha256=jgHSSQrC01wK16Apez4dSbKdDSd5TLDveDSNi2kEPRY,538 -awscli/examples/s3api/get-object.rst,sha256=umngd8MS7_L2yrBU7YyTFpQn5K_iEoyREplEgVsN46Y,818 -awscli/examples/s3api/get-bucket-lifecycle-configuration.rst,sha256=WEVxbOCJv4Y2CMqol28Cm6D_96mNtim8dDVxKjw3cC0,880 -awscli/examples/s3api/complete-multipart-upload.rst,sha256=RZXbMtjxnqOZXbfNNdIl1rTohIH0SP9VzDmMmikPMY4,1550 -awscli/examples/s3api/delete-bucket-cors.rst,sha256=d9zwD7o4DsSi1_xC928L57bCYiEK8um0vcT0mMMrLvw,163 -awscli/examples/s3api/get-bucket-lifecycle.rst,sha256=J9teIkMWx7aXI0QygelhCfjunORIdNKz5Osz_kyvhkU,631 -awscli/examples/s3api/put-bucket-notification.rst,sha256=1uOVoFss4S2vqZoCtvTFkCuPXY51PP7I2as5FifkqRs,1019 -awscli/examples/s3api/put-bucket-tagging.rst,sha256=SaDRsW6-PCVUcNZGqhZDvpSMseUsHB_LBpI0loek4E4,563 -awscli/examples/s3api/delete-bucket-website.rst,sha256=P7FF6bq3upELHPsXASxYLDSQTU3UQLXp7b3JvImQthI,144 -awscli/examples/s3api/copy-object.rst,sha256=c3W-YJDcQi08O_4o-ZhJpMeW8BVWsxMLtFxCfI3tDPg,386 -awscli/examples/s3api/put-bucket-logging.rst,sha256=iwi0OSAYPp5sP-e20cn-vHSUfg4gLxEQVtAqs1Hi9Lo,1318 -awscli/examples/s3api/list-object-versions.rst,sha256=-CRZoaLGW4Zpi17skWSeWXxfth7Ju5nFYER0MXQ0ZXo,2587 -awscli/examples/s3api/get-bucket-notification.rst,sha256=EijW57PyjevNcBgxthJLLLevBtW82VYjNc9SEEImYb0,468 -awscli/examples/s3api/create-bucket.rst,sha256=H1YK327C4FCLCZhxbCGKSiewOqocujuwhECusw8T12E,626 -awscli/examples/s3api/put-bucket-lifecycle.rst,sha256=gXSpZaI9mkdJ78TZmDh6wRQ6BofWI0EJ3S5IFzqlQFE,1598 -awscli/examples/s3api/put-bucket-website.rst,sha256=CvZAUFzMktqHtcjDOUuVgvhK2igDQzfzWsqmDgiF6r4,434 -awscli/examples/s3api/list-buckets.rst,sha256=hzcq9sNregdjEjz878ZEMnYoMUQKsX2sBjA37UbZ7bc,483 -awscli/examples/s3api/delete-bucket.rst,sha256=E1D8PiFM6iJkUMzVulC8qt2NN0SsGNci7jA1NAejlSo,126 -awscli/examples/s3api/put-object.rst,sha256=N1vg-JWv7BdAFlSv_0Wf3xuhEZ4-1s9nRW8nAki0zWA,647 -awscli/examples/s3api/delete-bucket-policy.rst,sha256=QfSwrkfbGlTDlfti68w2c0O5A0b9qi4wj4C6C31xdwI,135 -awscli/examples/route53/list-hosted-zones-by-name.rst,sha256=TMjTjw2BMX7khVakhlEWBY815CjDjqN1cgmk0H48d7g,1434 -awscli/examples/route53/change-tags-for-resource.rst,sha256=fMszV8I991itcAudHXjazpEWWWH3WaM9hDDuafClsfA,459 -awscli/examples/route53/create-health-check.rst,sha256=m8Fhjr-ghnIkt17XdfOoQFX6ONR7BWWAdPT_6SegyqY,1390 -awscli/examples/route53/get-health-check.rst,sha256=s5_HhHa12cp7vfY5_xFlSPWkscytqLG0YHAM6RDGuDM,293 -awscli/examples/route53/delete-hosted-zone.rst,sha256=_ZWuq9qPAwkjoGiC4FQK2ZrzXZ94Hdix-np4pqsJw0g,193 -awscli/examples/route53/create-hosted-zone.rst,sha256=QCtfz6XQb1VxQO-lf5ljpb396FvSZRwSjBKFWnN2iZI,602 -awscli/examples/route53/change-resource-record-sets.rst,sha256=cp9lvZl8s6cEtZwhdYYT_ukyxxbfrxH0bw52_2zNfyM,7633 -awscli/examples/route53/list-hosted-zones.rst,sha256=nfegtP1bCZLFfrda5287aL79KLmtuBg3c2q961Wtd4s,790 -awscli/examples/route53/get-change.rst,sha256=2-OjCJWUclV09ezZR7TAaIwOyELkRoKKQMDVOv91wgs,288 -awscli/examples/route53/list-health-checks.rst,sha256=PkdJm6-lp8twOqAmfURI15bMkIUPnyfZNx9--3aI-vI,782 -awscli/examples/route53/delete-health-check.rst,sha256=gvgjB3sun1sfa-mSLeBpCj1zYNWkAOFHHJ0bL4QinQM,264 -awscli/examples/route53/list-resource-record-sets.rst,sha256=16VaiX1H7X5CWFde5bclrUo6zXYF-XNgbSF9zuNmYoU,1201 -awscli/examples/route53/get-hosted-zone.rst,sha256=hcPpI3IzlABBcHt8YWZdL8MGdojO-CmTsji5lEtxQVs,215 -awscli/examples/organizations/delete-organization.rst,sha256=ZsdixkbeJTUzeTlLRk42XXl3xAEnDR-y4vqW_2R2Fto,337 -awscli/examples/organizations/disable-policy-type.rst,sha256=3Rsjxoqeu_rQ1HOydTutIZnoNl_DMPWNWI83ycAdqg0,531 -awscli/examples/organizations/describe-organizational-unit.rst,sha256=Y7lJ-lxg0_W6ZNlcTMvfGa9uwuqSEa4_PDW-4v29xgw,521 -awscli/examples/organizations/cancel-handshake.rst,sha256=Z9eTNMXm_ZMuE9BFrpfmStj0DVg7moPG29kCgCeM3sU,1462 -awscli/examples/organizations/create-account.rst,sha256=vlVKyp61H3noBDJmOIQLGO0jMBmy3GaL6ELIGbBPXko,1456 -awscli/examples/organizations/remove-account-from-organization.rst,sha256=qNjMiPGCQ_2jouqjQcqWTkrgKfDnyM8_SF5yeCb_w0o,211 -awscli/examples/organizations/create-organization.rst,sha256=csK82E4xSO9R6RR8DAemOcTUbTYD-ec-lTocbV2VC2U,1916 -awscli/examples/organizations/list-children.rst,sha256=kD6tcsJLePw6zXOLbT4-dXnFDH9zVPPcXHqoBvNvPeU,562 -awscli/examples/organizations/list-handshakes-for-organization.rst,sha256=aJfM8DawVf5G1hgxd1ZsdTB_N9M8gr-Q7d-YeLCuTUk,2447 -awscli/examples/organizations/list-accounts.rst,sha256=NK3hHw1xw-nqMXrh6JWpEmnqhszjMFEMcJ4alXzwOrQ,1403 -awscli/examples/organizations/list-targets-for-policy.rst,sha256=K0kzXGYkfA30QXs_hpVzp-EcYLPQUOQ_thvGEmmB71A,1035 -awscli/examples/organizations/leave-organization.rst,sha256=kijiw7OktDkA_-H4bV6HUDMwn3ai3HjD-vJ5uXI9g6A,224 -awscli/examples/organizations/describe-organization.rst,sha256=JrrJjPR3MZCP37x0r_zU1Z2QN09SOgVIQw3op9VBk5E,720 -awscli/examples/organizations/list-create-account-status.rst,sha256=U8WXK2zpjkOpcw_nN10mtOOzzHku9otbE4ijFGXdZcM,1250 -awscli/examples/organizations/update-organizational-unit.rst,sha256=wlGTX0KYGMSZcA_uocscqnMeTo-tMCkacrS4nD2a_ZY,493 -awscli/examples/organizations/list-policies-for-target.rst,sha256=Yxdgl8D1sVDGsvIb-FIF5ccb4Sq5sJ2QjXZhL-0qfVs,956 -awscli/examples/organizations/invite-account-to-organization.rst,sha256=YHk1mieabbtGtRyvqNUJi5xS81usMmInekgMs0Xl0gU,1367 -awscli/examples/organizations/create-organizational-unit.rst,sha256=cYtv_6k1-AYmKsw93_qkQy_MNfolTY4RvOFRGIyA0G8,517 -awscli/examples/organizations/describe-create-account-status.rst,sha256=cAnYxGTgdHY1XBmahUxEKuN7jJ1i9u4gIJ2_ivf5o9w,831 -awscli/examples/organizations/update-policy.rst,sha256=5nSVZ_dlrUKrmYw2YMfPerxAFeafy-JYZV6o-1UiuTs,1757 -awscli/examples/organizations/list-organizational-units-for-parent.rst,sha256=15TmYNyLcuVPnN0FwwudQ5bZZ-6xFBtGZcnuwV03mPE,664 -awscli/examples/organizations/list-accounts-for-parent.rst,sha256=sA4Osq5G7w1ryZ35IGRrLCjE7-NQH9WazvdWknDVohc,899 -awscli/examples/organizations/enable-all-features.rst,sha256=QE7syXWuNYEz4-MiZyWw9zAKLIxUE_7lOp5KDk4WM18,1262 -awscli/examples/organizations/decline-handshake.rst,sha256=6rmqpDXFdEcJ0ZaiknSEj2TkLcXQK6o5b3gd1YAQrjs,1396 -awscli/examples/organizations/describe-handshake.rst,sha256=l1K24iy9s_afVKDmwEH_kAHxKbv-n6zv81ke1S2Rum8,1277 -awscli/examples/organizations/delete-policy.rst,sha256=rwEk_pOLSvY7PVMiDLMXwY2BWgfPfrZNhn4n6nGCtrA,245 -awscli/examples/organizations/move-account.rst,sha256=DKr09pfTDbGuwCR6MVjRPFVCydZ7sJTrpwOR10vww5w,310 -awscli/examples/organizations/list-roots.rst,sha256=Pn6U5iFvJt1YmSPtGWwgADU9I0_3YzlF78BC9LEridw,521 -awscli/examples/organizations/create-policy.rst,sha256=yCn0zF7g6F0EJqIhq4fggAYT4hs-m-m27NuYUNkFfU4,1863 -awscli/examples/organizations/list-parents.rst,sha256=ZZ0tnUxMJh89PpTm3peicLRKsuYr1dgJX7bwRessV1s,425 -awscli/examples/organizations/list-handshakes-for-account.rst,sha256=Nz6eLdNs36kgz486eYC5AiwmslQR10NN5jRlxbXrT3U,1284 -awscli/examples/organizations/enable-policy-type.rst,sha256=YT_kKFpT-e0ZQsfESMnycnGm4111pAo4sKkSK2cWWJU,623 -awscli/examples/organizations/attach-policy.rst,sha256=tAYaLOYryTLlbSyqDvntzY3JChiWlNZ95Tpl0KHxbFU,485 -awscli/examples/organizations/list-policies.rst,sha256=RnauW8wwJe25dpDEP1JPcLg0QAYornOGFGXhBsO6PdU,1347 -awscli/examples/organizations/detach-policy.rst,sha256=dstb_WspehG_zPYMglMKqrdjvsAqqjcrR31SXMzwbTM,234 -awscli/examples/organizations/accept-handshake.rst,sha256=jhdMFT_7wkUzeN1NTXAHQwMz2aSXzF-ifpVLq6PTpdY,1259 -awscli/examples/organizations/delete-organizational-unit.rst,sha256=QiqTzwTBRiIT0g-eaHvWOP1MQh9rXZG4eVKfjZw5yvI,268 -awscli/examples/organizations/describe-account.rst,sha256=NbC3sybK1MISfCOSf4JmTuwyO-FoL54pHi-1QoSfpOg,541 -awscli/examples/organizations/describe-policy.rst,sha256=HcoYi4qhsLuu8xi1AWX10Vc1TsNBLjL1D4mRW3kwTV0,799 -awscli/examples/swf/register-workflow-type.rst,sha256=my9idmWzv2rbC5BvSqvzCMbhVFHKRtrv0bQ371VXzEc,948 -awscli/examples/swf/count-open-workflow-executions.rst,sha256=wvQRnNumX98vlwr73HjzXGXEi_l6BgoQt6SmzJAJukU,1321 -awscli/examples/swf/describe-domain.rst,sha256=62BdLFk45gkyhO1coSyXmUpzm2MNqbUeXqUvs-PmneQ,1094 -awscli/examples/swf/deprecate-domain.rst,sha256=YEWbxJlDZaw-23TyNzlUjkC5DbDruaJMiiyKI6Oabp0,1759 -awscli/examples/swf/list-domains.rst,sha256=TeCPsfsDmFk-JW_Kpk6k3Gh6ujNYao2taP4xFGsSXxk,2720 -awscli/examples/swf/count-closed-workflow-executions.rst,sha256=-T4e2AqSdCTU8nKGnJK4krnm9Ls6bOdp74MuBrKYBtQ,1462 -awscli/examples/swf/list-workflow-types.rst,sha256=UmnfYbPiwUWMnLA_69_0lH7BKZ4FNTmWsFdp8Dff8vc,1175 -awscli/examples/swf/register-domain.rst,sha256=etrI40YstVGS71F89qROMBaSo9hVCX8xAv-PBqU7aFY,1820 -awscli/examples/swf/list-activity-types.rst,sha256=imkhqwxbTU36jRLm9c4ytufiWCQIXhlfwBS-syouhvo,7143 -awscli/examples/ses/delete-identity.rst,sha256=i7NKOj97eDKk1O78HOj_5MjGKNg41V3ctPqg1lcmVnI,529 -awscli/examples/ses/get-send-quota.rst,sha256=vQDbFeh5fJ2vK87OzDeqNCnWdKysaMTuzhGTKNFTUmM,1260 -awscli/examples/ses/get-identity-notification-attributes.rst,sha256=fMEB6dmTNAuWHfXbF61ha2zlxHvbqMbKo2qGVTDOYuo,1369 -awscli/examples/ses/get-send-statistics.rst,sha256=CAtOGeB8WKva2a0c-AK38Di9bxLErJqoh_cnFLZWbHI,1188 -awscli/examples/ses/send-email.rst,sha256=YzHPMUZiqvJkcAKxn5fjvLBruEpVGqHd3_SzA41Obos,2286 -awscli/examples/ses/set-identity-feedback-forwarding-enabled.rst,sha256=MRJv8iscHYX7huig4oSB2iucmkbPcuvWMM8IpEjAOLg,890 -awscli/examples/ses/send-raw-email.rst,sha256=USYwh-mt6PlV5m22q6ieoQyv-SbGDa2j_T5tXazLk9c,2068 -awscli/examples/ses/verify-domain-identity.rst,sha256=I13uhuinjk0-s0c9080EceJcwgxFkbWB2o8mRs6dst0,630 -awscli/examples/ses/verify-domain-dkim.rst,sha256=taDHsxLIJA9s29rsWgz1wu08pxULBh_NVwsHk04kA74,820 -awscli/examples/ses/set-identity-notification-topic.rst,sha256=Rse8G9yYWkr9udL80zg_SbNgV69c3RqB1VcU3fPYt_Y,728 -awscli/examples/ses/verify-email-identity.rst,sha256=u7Q7NdT7i8afYZvIBDZ1aSzpJmU93ocykleY0wzh56g,970 -awscli/examples/ses/list-identities.rst,sha256=4P8mMUjsxZ-gv5C5aHDC0aJlou9yN3ohpSRzHIhIToQ,906 -awscli/examples/ses/get-identity-dkim-attributes.rst,sha256=CIQoYWtkfMacGCO-Ox4UoN2MjB3TyqgGbkmK8frOkFg,1152 -awscli/examples/ses/get-identity-verification-attributes.rst,sha256=LqOp0NVE4CgW5XXk6KLrXkNRLzhQ_ZGy80mBtbZ5LWg,997 -awscli/examples/ses/set-identity-dkim-enabled.rst,sha256=PMZy24s8BZwnLfcM0_-DCCRHDmrHARWGgK8DSHcGtl8,498 -awscli/examples/ecs/deregister-task-definition.rst,sha256=mf_xyu7qLka1oGNc5YcPEudbIsifc5uYjjazeLykhmQ,1107 -awscli/examples/ecs/delete-cluster.rst,sha256=-L6Q-SPq5mQ7B3x142S0WY5Na1-6gHCgbUfNxzihyqc,497 -awscli/examples/ecs/list-tasks.rst,sha256=VTJcUDk9cHIKQi_2TT4dyTf0Ji9yvWnnmYhXjmSTXi0,794 -awscli/examples/ecs/describe-task-definition.rst,sha256=QmnV0Z95K66TEYanM1hACKM-7mfpyDEWp1JdV3KpEck,1550 -awscli/examples/ecs/create-cluster.rst,sha256=GxyyolczEkblLSO8DTdGs8RXCIWqgWI8w7uGml87duM,498 -awscli/examples/ecs/describe-container-instances.rst,sha256=csnTwl5mtr5vI7K7zVXXdbPQTHUU0FOMwIBJvmDi_P0,2838 -awscli/examples/ecs/update-container-agent.rst,sha256=GoTSAjeV4-rg4lvGJi2r-q2edjqp27WSCrTtpN8lKno,636 -awscli/examples/ecs/list-services.rst,sha256=gwh6GKk2U1io8TPGIkFFj0SvbZZC0bZfJR4OBId04iw,263 -awscli/examples/ecs/describe-tasks.rst,sha256=ztZme1r10l8wfvC6TyfKKfReGIVCrkX0Mio0JUfkeh0,1732 -awscli/examples/ecs/register-task-definition.rst,sha256=kSWp8u4K5HsPKVGGY68kMy1rtB_l6iPm2U9_hQsLTvY,2849 -awscli/examples/ecs/update-service.rst,sha256=sBglnicjtoRE8lfuULycS6jL5ufhLJ3bCCadqha4BtI,484 -awscli/examples/ecs/run-task.rst,sha256=WIs7VTzjy3wcseLg4tGGTZ5cR1LavRGMIR8uCSJ6wLQ,1287 -awscli/examples/ecs/delete-service.rst,sha256=8MIM8K-PvHoHDl6357t3p-fRfyrdCk80v9GUQU_hYpc,238 -awscli/examples/ecs/list-task-definitions.rst,sha256=Wapn00oonckjGDALspqZzUmFGjMpupt7qQSQsKYgMmY,1257 -awscli/examples/ecs/list-clusters.rst,sha256=0O1qX0Dw9s1vx0il_fj_B2ZaXBIVTEqxQdfqXKZdC9k,331 -awscli/examples/ecs/create-service.rst,sha256=aZjCRLdVdi4Mb1R36S8B8Jg2oWjx9bT-Qx1KqxHcGr4,3569 -awscli/examples/ecs/list-container-instances.rst,sha256=Ks-SJWDAxxdjmG6lL7ChM5NovF4mRigkLve2L5vH1-8,531 -awscli/examples/ecs/deregister-container-instance.rst,sha256=MvClTZfbpPheMqlZMt_x0f3jZN-stPtd0vhudKU7pMo,416 -awscli/examples/ecs/list-task-definition-families.rst,sha256=HuocKwpqTX5jO06iocwFmW_sKQr9GcWv7oEuKEEke2I,613 -awscli/examples/ecs/describe-services.rst,sha256=1jtcglDmnyZUkXn7M8VT7IIlIslLxi9P_FM7q5ibjvM,1642 -awscli/examples/ecs/describe-clusters.rst,sha256=KdVMoo819mYFNGci27hBUw79uwrKH1l_etC1IdlaCU0,586 -awscli/examples/s3/rm.rst,sha256=Fr8hbKNIHPyfmckrfBTg8xA9mSR1wWhQtErlWqD5ZSc,1367 -awscli/examples/s3/cp.rst,sha256=qNrHoJ0eh9G9zBbx-AVyToR9sf44Y3Ka23vdMUpP5xg,5388 -awscli/examples/s3/mb.rst,sha256=ZWT6PeLtWPhfW7MTqdqgoxY2SrlmOaZvbLl4vJ9V9fk,535 -awscli/examples/s3/website.rst,sha256=_oZPu4ANiMWinN9LOj70ChQdSLLatMiF8kbdwshk92Y,883 -awscli/examples/s3/sync.rst,sha256=8Aiw6JcPtUKE7NP26Hec-BHReD9MAyClEvqw2TgO6uU,4753 -awscli/examples/s3/_concepts.rst,sha256=0dH1OP9nqcA9jFxNQIsaxxDy7RVlDbZgQaFmMFd5PA8,7029 -awscli/examples/s3/rb.rst,sha256=-qlm58-6w1yz17Nxh-Zu1BUq2rojQoS5NJSKbOpiqJw,641 -awscli/examples/s3/mv.rst,sha256=0u9OKbMixaB9DNZSMWVfGwFBx0XMWbHUwF7t8T1lWY8,2834 -awscli/examples/s3/ls.rst,sha256=yFo0FSAnAt7nv1LRHbPhrFV-_m74x4deQ8C13fdwk0Q,2875 -awscli/examples/iot/create-certificate-from-csr.rst,sha256=roElGLvrv7Mdxf4w3oFNK5n3vYVqFVtfD4E-LKm4SSU,1532 -awscli/examples/acm/delete-certificate.rst,sha256=pC5eX56jNhv-6EYgdHZ8mZ3HCB8cwG5zRqM67X536mw,277 -awscli/examples/acm/request-certificate.rst,sha256=k3uJEn3daas_dZ8f8wTiaDXXStsYkfoXYfAK2v30mKA,2093 -awscli/examples/acm/update-certificate-options.rst,sha256=17SLZZ_VGuT-rnnl0Z9gX3v1nFHdCUN4Qq1JteCtOAM,332 -awscli/examples/acm/resend-validation-email.rst,sha256=RO3wPg_MpOiudZFspHHp2FaHjk6QxgSNRlSqh4377H8,404 -awscli/examples/acm/list-tags-for-certificate.rst,sha256=cEYmWzwBOxU2FUh2IDuJxqshuPN8vYLynxrvK-pkvbs,554 -awscli/examples/acm/remove-tags-from-certificate.rst,sha256=6cacCjB_OBdtfFft9jeIYX6qTolzPtr3rlW46Y4_dKc,389 -awscli/examples/acm/list-certificates.rst,sha256=Qph550yJpBHxDp9m04prj_RXTf2OEwPozqZePBkyAD8,2566 -awscli/examples/acm/get-certificate.rst,sha256=WeSqK-Rc366v7cs1Q8qwQTOm0oYxzACAX6vPG4amYGw,4282 -awscli/examples/acm/add-tags-to-certificate.rst,sha256=rEuvDA91-qBzQSQCrGHnhsl4ptbCD2ScLxq_U-9cWco,376 -awscli/examples/acm/describe-certificate.rst,sha256=dowXjlCXkZW--H-Krf-vvAfrmiDA1k5TBk8VFYprGSI,2136 -awscli/examples/opsworks/register-elastic-ip.rst,sha256=5-8WiMakgXChoEp0Id_A6iPLeRMEolChu1dZ3VA_3E0,697 -awscli/examples/opsworks/start-instance.rst,sha256=gw44zmh92J1hApEzBVVYgntntRBzU-GM9u1QL8NkJpQ,851 -awscli/examples/opsworks/unassign-instance.rst,sha256=M5LpzMo3hBuO2l225-MmDLFAnansqSOFSR7GBrQ2Iww,524 -awscli/examples/opsworks/update-volume.rst,sha256=TGidSeI7lZKsyvdbb4EyrM6ZJYqgUVY2Pw45mUwByoc,758 -awscli/examples/opsworks/stop-stack.rst,sha256=NJrWY8SN5SkP1cIn6uAXz8wtELV7eQSmGbzb-Q3fIcs,519 -awscli/examples/opsworks/describe-instances.rst,sha256=svxiWmO3H9BC24R7eIdSiTXui0vvv7YkdeZQ8hjtBKU,3404 -awscli/examples/opsworks/describe-my-user-profile.rst,sha256=Txr8Cns1Dk4-rvKkEy3Da6sgjMt0dWJh9UTx6uVffsc,841 -awscli/examples/opsworks/describe-timebased-auto-scaling.rst,sha256=LGY_QuxPNSgeGbYMEGaiBVrKDme_5NmY6V4w7pxaBZs,1228 -awscli/examples/opsworks/delete-instance.rst,sha256=0hF6QSoWhPzoPkCaKWTTp9dR3_JgxBifTzjoMhK87_Q,1092 -awscli/examples/opsworks/delete-stack.rst,sha256=Q77N3FHqbGOhsv7TDwUMuukAF5Wku5BTMVm28mnvohc,733 -awscli/examples/opsworks/set-load-based-auto-scaling.rst,sha256=cqb97WuSBTc6wNSWDlibT69iYXkWWpOLN0_gRdlO38g,1350 -awscli/examples/opsworks/create-instance.rst,sha256=uakNfK_CaQStAyVeEju-58LlhfVZFsbFFoU4dHu9wQs,1042 -awscli/examples/opsworks/deregister-volume.rst,sha256=pFKC10IhgWSC3EQAdipCJx0EGFMUnjaGRFLJd-3hVOI,638 -awscli/examples/opsworks/describe-user-profiles.rst,sha256=ix4pABPPr684yN8WY5BqKpg3odbwLvLKj3SQ8QQq6wM,922 -awscli/examples/opsworks/describe-rds-db-instances.rst,sha256=OId_3mzwQA1JoXFv0F6FV4XBSTyF4cq7XgsAqlAxx2w,1013 -awscli/examples/opsworks/update-elastic-ip.rst,sha256=sExNe2EE4CeAm1Eky3iCfnIyApL8xq7113aparBRZaY,436 -awscli/examples/opsworks/set-permission.rst,sha256=z_CkUgsTO4rQg7Nmqmws3wSVXFQD5lsRGlpafS76JkY,1268 -awscli/examples/opsworks/update-layer.rst,sha256=IBP5VBsvXjglv8-NMWhn2kLMc129uiiJmSWNboI7tb0,519 -awscli/examples/opsworks/describe-commands.rst,sha256=nkJukBip0heKnlRmx7pm9KnL0bZKO7FqGlIYXGPnbPk,1988 -awscli/examples/opsworks/update-instance.rst,sha256=0HBdh1Nnxoy0Sdyz5vo2XHDilk22eyNhsk1Sq7vWF2s,485 -awscli/examples/opsworks/describe-stack-summary.rst,sha256=xnchmoNy-WE0Q_xU-kwu4yoQ7On-YdDgsmSVeIxvH68,770 -awscli/examples/opsworks/get-hostname-suggestion.rst,sha256=DA3Obxm5Qe0GtoHq7G6Cl-d64rUXEY_4BHS6AM931iM,695 -awscli/examples/opsworks/create-user-profile.rst,sha256=uuII6oEmY1YUxE-7FqrNgZleOPBJitYSEWpxkVAZDoA,1173 -awscli/examples/opsworks/describe-layers.rst,sha256=GmiV4bs2UtIGsR0M1iTKcXgKskD4OuHWWPcMHb_eGW4,5773 -awscli/examples/opsworks/unassign-volume.rst,sha256=agaU9aT06LiXQvFB5UMv0ZyjsYW1BYq_vHZ0Z-vkUQM,719 -awscli/examples/opsworks/register-volume.rst,sha256=xZp_T7CCV-tXYwMbYGSuL9-2UihnM9Hy__uxbqpO2AY,639 -awscli/examples/opsworks/associate-elastic-ip.rst,sha256=i41AroX6Ur7u-DhN8AX2HBwRs_DIzUJI01Hv1PNnHUE,496 -awscli/examples/opsworks/assign-volume.rst,sha256=vDiCLbLbsYTUmUyjyMu45IyLU8x2lSvnRGzm8OL85gQ,905 -awscli/examples/opsworks/describe-permissions.rst,sha256=GL2YdYfaymO_x4XNJ4uo_Qmq-3VCzY0L87jF5arX0n4,903 -awscli/examples/opsworks/stop-instance.rst,sha256=HZzsNb_F4wgnb6rxkf64JI7gYtxRoxKTDh9qkk0qDgs,762 -awscli/examples/opsworks/disassociate-elastic-ip.rst,sha256=JDzHTEEyL1Giclg1R9Sy1VRDx5mG2pCYbkfg4DANbGk,454 -awscli/examples/opsworks/describe-volumes.rst,sha256=PQpC8JIuG4Hp5brRa95d7xtHPKz4skXTZKq7sSgarNs,835 -awscli/examples/opsworks/register-rds-db-instance.rst,sha256=PNSc_unXhso0GWl4Da0nvm_SnWq7E9UZaw3g6yyXEz0,918 -awscli/examples/opsworks/create-layer.rst,sha256=o8shHPJkMGGdyeFQ1Yfv2qtYqma4_ZHxsukA4QnOBOU,586 -awscli/examples/opsworks/start-stack.rst,sha256=ZGPSDY9d5r5r3Axu6_T4XjzjAKu8oXIZpjHZH1Ck0rg,520 -awscli/examples/opsworks/describe-elastic-load-balancers.rst,sha256=D6VVub1Ugs6b3485uUypmd-Lyiy5TEKYCe18GBKEF9M,1150 -awscli/examples/opsworks/delete-user-profile.rst,sha256=gYTTQcWitLcwFiublEiOn3D58x30qXiizR92FLDjrCo,765 -awscli/examples/opsworks/attach-elastic-load-balancer.rst,sha256=bo-1w6w4924uTK7BIhWyFEg6wMzjG2omhB7zSd8ulXM,523 -awscli/examples/opsworks/deregister-elastic-ip.rst,sha256=PqDcnrTXKwDOnv1Bpx0M2uSoAAsc7DhvFeZ2_WOZfJo,520 -awscli/examples/opsworks/deregister-rds-db-instance.rst,sha256=YmWtIuMKlrhrSJ2qHHsmGjW0uMyc9Qf9C6NwaohdNmo,791 -awscli/examples/opsworks/describe-apps.rst,sha256=XY_JsscEP_fV1WG_Dqdr4f4X5E1BOYp9z06QTh-pmxc,1066 -awscli/examples/opsworks/describe-load-based-auto-scaling.rst,sha256=p8IC6XNCuy6aDtHmP4qSgUGxIQnFNa2reTep1MHhj5Q,1253 -awscli/examples/opsworks/describe-deployments.rst,sha256=BDa_NvnzxlAzH_UCc54LtcLjku_GPsIdwW6Pdhnb5PE,1717 -awscli/examples/opsworks/describe-stacks.rst,sha256=L-UWKW25gEV2h0sRWRKuzShiamKweMFk5fIGU2Eo9mw,2271 -awscli/examples/opsworks/describe-elastic-ips.rst,sha256=kvxJgae6qsoFCGyixqzIAl9JokHj1kMqba0cI26A7wQ,608 -awscli/examples/opsworks/update-app.rst,sha256=9uDuyH8DKmFkDV7JQVNbiUh5piSswcNitdSma4OSXUg,417 -awscli/examples/opsworks/register.rst,sha256=_0UksLshlkF2CTl8vyoJVkOkKe9fADDCSPQW8STbYGQ,7018 -awscli/examples/opsworks/create-stack.rst,sha256=3XCNDx1ydS9u5LkRPV0vM8QE5v4apMii_f7eUMVam1c,1081 -awscli/examples/opsworks/update-rds-db-instance.rst,sha256=hJlZBhXLXgwOf3XZlb28XMNJSo1swJc6dcS0TrQdqiA,758 -awscli/examples/opsworks/update-my-user-profile.rst,sha256=r9fX8wu20hGW_aflUXMJ_kGBfE0Ec2Wf5iqX4vl1jSY,723 -awscli/examples/opsworks/detach-elastic-load-balancer.rst,sha256=qQc8s_kYhfdsoLU-1pXn7Une6OfY1Rd2TN2j222Owjo,521 -awscli/examples/opsworks/deregister-instance.rst,sha256=c2jdB9ZmXVa9W5flMaFDEOhMXJlEQLiuXYqw5aiH-0E,531 -awscli/examples/opsworks/create-app.rst,sha256=OUOiaHRyt4yIVAQFRIZnm7R3-yJXp-Sj-_vgL5T2pn8,2005 -awscli/examples/opsworks/delete-layer.rst,sha256=N0Qj6X5BO0-jMD99U39iPwI-9ctUuyTqiLTkPaRMGxw,712 -awscli/examples/opsworks/delete-app.rst,sha256=py0J7_R8LsdOT6naTlqfjTaspXE7sRTE_Usm7OUe4TI,525 -awscli/examples/opsworks/reboot-instance.rst,sha256=HmgPZXxX2kUb210D-R_9pGgsccigI3nqjNxYPpCJC00,448 -awscli/examples/opsworks/create-deployment.rst,sha256=twmGaanYJwRnb_tYSAHDDLiVecG3O0I2G7MBOrUF_CQ,2513 -awscli/examples/opsworks/assign-instance.rst,sha256=wsJm0fwTYS1SApYoo0nsiYmgXx2ivRqnx0PZJx9zhHQ,557 -awscli/examples/opsworks/set-time-based-auto-scaling.rst,sha256=XJeaeKFRWYHu98b1rDDKD-eVsFq8cwaw-l5uHY0zDC0,1082 -awscli/examples/opsworks/describe-raid-arrays.rst,sha256=2fmP0eaFm1OzI46mwJT-wsJhuZY5W97X7TGdCdAsJgo,1073 -awscli/examples/glacier/list-multipart-uploads.rst,sha256=f2D5vPx4yTUoAPYUBLu1no42LsDQX0EyIrQvBKNEMpM,546 -awscli/examples/glacier/abort-multipart-upload.rst,sha256=8O6y4y9YPpPAXvnR8vugtOHLtTbtN4Nkjo0q2TM_nHY,837 -awscli/examples/glacier/get-job-output.rst,sha256=TRxAZlkXo5vyHNzm-uugJe6dxcEiWN0m8jy9sS0c1cI,1201 -awscli/examples/glacier/describe-vault.rst,sha256=qIIQMoNqra8qIlGjGKxDatm_fUuyUX26FBANIPrPhos,270 -awscli/examples/glacier/add-tags-to-vault.rst,sha256=BioRFLJy8JUDcKYi1uoTj5Pa-M6jSi_Aqex1g7fCRbc,299 -awscli/examples/glacier/initiate-job.rst,sha256=TUG3AIWOT8HgpcrglRpEmpH-hCP3-DPu3ygbbtcuOag,1869 -awscli/examples/glacier/upload-archive.rst,sha256=4TmVK6iC3WakBxYrf7ZYU8OvbRl5fqXy9oYL4bgdmUE,1011 -awscli/examples/glacier/list-vaults.rst,sha256=jJ4SEh6Lbg749xhKu10Ms6KxJfjZqDYWZcg1JUJcUrA,639 -awscli/examples/glacier/upload-multipart-part.rst,sha256=MFCZl6IPQGAJWoRESt2YEVgIn8TdFZ--G_bcTN7XUek,1020 -awscli/examples/glacier/initiate-multipart-upload.rst,sha256=0p-jCWr9415pHSyRC4anuWxEePPKxdsYcHcLa4Agav0,851 -awscli/examples/glacier/set-data-retrieval-policy.rst,sha256=jFwNle8IR8kqkzVmubOXr9Z-IWrsrCarSZhhEHUg6WM,965 -awscli/examples/glacier/set-vault-notifications.rst,sha256=cvxZm0yvANxby4YC77BU_bxuouRoG_WFU7R1WxKoYfg,620 -awscli/examples/glacier/create-vault.rst,sha256=dzP3uKFuhzu5W6xMBC62IZXvz3p1og6WTd4bL1Zimdo,259 -awscli/examples/glacier/list-parts.rst,sha256=WO8WtnnfMadarWAMFHjPcykYOO_d-qBFK2IpaycfNqc,1307 -awscli/examples/glacier/delete-vault.rst,sha256=y7fFN1JbZ0UII3q0yuMOMnKsIzaCfdN9OPlLvSff8oE,297 -awscli/examples/glacier/list-tags-for-vault.rst,sha256=h3PaysMRhynF2S3KLAZicSbFWFVeaX8kf_KJy0sPZ0M,377 -awscli/examples/glacier/get-vault-notifications.rst,sha256=e_EUVJPJbpmrqpFgQp76fFAK9Oqk8Q3Ent41oGevLRw,647 -awscli/examples/glacier/describe-job.rst,sha256=xOBcTxKZ0D_GAlBiRgCVxUnZu5BL1Ja62X3w0qraCdY,939 -awscli/examples/glacier/get-data-retrieval-policy.rst,sha256=szGxN7DflpD66KYK1qLtEI8KAwVeFnnuZbN9-RcSXXo,468 -awscli/examples/glacier/complete-multipart-upload.rst,sha256=_73uLBdwFOs-D6iIpRaJ_QjXuG_5s-dXJkyayvOHFUE,1007 -awscli/examples/glacier/remove-tags-from-vault.rst,sha256=bjSTERmc4upJaLjDgliBb9ggqDungkDCG5bxKZQkU98,315 -awscli/examples/glacier/list-jobs.rst,sha256=Bj7OHzbGdIx3cfeq2cZuVSnqR_tZymsVWuY-4Lw2eTU,1866 -awscli/examples/storagegateway/list-gateways.rst,sha256=xXWs2D3zI7vG_cgpnZCV9ckZKazhJHH6kL-ASkBRsK8,260 -awscli/examples/storagegateway/list-volumes.rst,sha256=nE3LBkJMyhtb93TxZafsnYP0TaUsoNZ5bQTQ7UW8o10,577 -awscli/examples/storagegateway/describe-gateway-information.rst,sha256=_p-HPpWajykMEd0_6Ag_NX_N9egeGAQB8kMahfGURgk,657 -awscli/examples/sns/confirm-subscription.rst,sha256=n8IaTx-MfY6vKSw-tnlTg8WBS6rPqA-jvU-J3s35eT4,651 -awscli/examples/sns/list-subscriptions.rst,sha256=yXf_A-NxetVHpGaPGNlycvB6XizoKTZxYaKi4kVtx-Q,484 -awscli/examples/sns/list-topics.rst,sha256=qAqwMME3QbpD7AFLay_uoEbU2X8VfxAKzcNXeKZ0YrA,220 -awscli/examples/sns/create-topic.rst,sha256=_gWZMxmFYs5dKtEoFKkPYwwx4NvWCyaiAstj_6Ge4Zg,587 -awscli/examples/sns/get-subscription-attributes.rst,sha256=GBUSIiECrQPWFZPy--TJauwDsqdORZQJ64As5PtltQY,758 -awscli/examples/sns/list-subscriptions-by-topic.rst,sha256=m0shQJmcfTqOuGj0dbPv9w8RcFHdqyhCWNCGxxw7cwc,552 -awscli/examples/sns/subscribe.rst,sha256=usmWWtWtOA2z-lb6XHjKFDn9I2m3xuh66DQvMbn6T9s,270 -awscli/examples/sns/set-subscription-attributes.rst,sha256=lOG_QLnOKXROtjFMXKdjPyoiXmUKoerWYABSQtKn4rc,976 -awscli/examples/sns/delete-topic.rst,sha256=hUrbzeDJooUn-fFfIFTAO1k5LjvgyPT9QwwIcPOlDAE,146 -awscli/examples/sns/unsubscribe.rst,sha256=IeTC600n1UxROnlpveETxoEYPdYMha01GsX16bbTHoM,173 -awscli/examples/sns/publish.rst,sha256=C8HCraF01qmf5VCBfQIOywInV_JvV1ZtvjLz0oL0VqY,353 -awscli/examples/sns/get-topic-attributes.rst,sha256=5MTkFMXtbHo0mGCkxa3pvXNL_rQd0w4_zsF8Lg6w51c,1304 -awscli/examples/ecr/start-lifecycle-policy-preview.rst,sha256=Zuo6J5_WbXE0DTle9k98wTnQnJCTxWWUCGAyThE3FfY,1485 -awscli/examples/ecr/get-login_description.rst,sha256=9P1Qy96r_kYo5Ywfl8AaMXEjsRa9urSPONNlh9qhby8,824 -awscli/examples/ecr/create-repository.rst,sha256=gWUTtSc_em0pwPgmtf--jX8SD7Es02pWa2n2S9Ub84M,495 -awscli/examples/ecr/batch-get-image.rst,sha256=yN5A536X0xcmZEA21K66n-WjKEwqtpOThJG0eUWzke0,249 -awscli/examples/ecr/delete-repository.rst,sha256=fdeoPIuhMyvkiVsqnxgtAWUus2hewLWA8AxYwfM9_Lw,491 -awscli/examples/ecr/get-lifecycle-policy-preview.rst,sha256=tVSVajGLvLPGpWNHPvYKTM4tB_Haz_smBE0qrDSNWPk,1046 -awscli/examples/ecr/get-login.rst,sha256=AbGVaTXaQuFlBL0djW4nTF9oV-uMBZEJ_Hx-ZPb8n1M,683 -awscli/examples/ecr/batch-delete-image.rst,sha256=hxy8C1B5hzcSLsAuCsR3pE_BSdJ4h84C_Wgl6xXjsgI,481 -awscli/examples/ecr/get-authorization-token.rst,sha256=n7Lehg-_bMmSe2iW_PeYHXiozonHE783NkG9avbf7Mo,1628 -awscli/examples/ecr/describe-repositories.rst,sha256=ejcWjSkqvMIpMBnMM6IvlKXLR1uwGzulWZnpi13h1mA,612 -awscli/examples/ecr/put-lifecycle-policy.rst,sha256=QihAonYry5coJf4kk6ojERZcCKcVK0GIU8B1bQIuVAo,1198 -awscli/examples/ecr/get-lifecycle-policy.rst,sha256=_WZJ3bRgqEJHPBfQq2jfy5G8hud44QTP1vgRUqKrGZg,698 -awscli/examples/cloudtrail/stop-logging.rst,sha256=5X4FWOdeN6pg7yN4pHw4R3oZngLs2QuML3Aq7Du4idY,153 -awscli/examples/cloudtrail/get-trail-status.rst,sha256=emOlulnkOV-uDbxD8ZaWGuTjkoVQgT5b031F8APtgz8,825 -awscli/examples/cloudtrail/delete-trail.rst,sha256=U-PSaOr6D1Ykk6QkNxwsbbKPmSepnZMJW3mi6JdJM3s,149 -awscli/examples/cloudtrail/add-tags.rst,sha256=uEjK6YbIm0TmVEemUy7nJ15XcoFMU4ATLVaP7hdE-OA,244 -awscli/examples/cloudtrail/describe-trails.rst,sha256=2l9FvWlA0WjbiW6AShaCujgSefJZvJpisEgr7BhYe7E,1340 -awscli/examples/cloudtrail/validate-logs.rst,sha256=s-FpQPivasuD8oXopgbDcMXErMBoT6VVaqYTRBBPVQw,583 -awscli/examples/cloudtrail/create-trail.rst,sha256=k-jdqBTMuN03MXF1zCZswMuZ5jMB_vLbU97k6WDnOAY,513 -awscli/examples/cloudtrail/list-public-keys.rst,sha256=6dFGbLyqIc6bWkjBEF2KppCHSz6RpKM3mDJOgKVWptI,890 -awscli/examples/cloudtrail/start-logging.rst,sha256=aRx6ewSe_X3fFkBFKb8ilyjBclJd4fjhlkjGS4LiKDE,159 -awscli/examples/cloudtrail/update-trail.rst,sha256=szhXEmHstQfrZFoN_lnWj13M-_aJ2wyG46dHyBjrnDk,472 -awscli/examples/cloudtrail/lookup-events.rst,sha256=HIAHURLR0o9R-1gwXA3HWhuXnFwWzH2_PmQby4lRlRA,1690 -awscli/examples/cloudtrail/create-subscription.rst,sha256=zRzf5iTQpuxbSvXPaeFtL0Jgv-TuCIQ2v8xK02xjHYU,1004 -awscli/examples/cloudtrail/list-tags.rst,sha256=G_FuTlHq5X79IHMAIUdN4uJJu29xM1zwErnYU1bi9k0,953 -awscli/examples/cloudtrail/get-event-selectors.rst,sha256=TlPmSt40_7NLMyXZkxjBV84_MxjVPk2E61LL43Vp8lY,451 -awscli/examples/cloudtrail/put-event-selectors.rst,sha256=c_v6wb2rXyoWYSsRsOTeWlxQ10YSvnmV3FjZmtuJUwQ,3012 -awscli/examples/cloudtrail/update-subscription.rst,sha256=p2kF6eLCfGjqlrWGz9ZvURfIp0scFpjNPVRUEoliAxk,959 -awscli/examples/cloudtrail/remove-tags.rst,sha256=baDXOQKHf9H0x0YxDR_EdrcIEU5HTVDUxQkd75LNVyA,252 -awscli/examples/opsworkscm/update-server.rst,sha256=GMwr3wylG4Tdqe_i3nqNB0-wMwsOeRxOv2-uyyF6OOE,1816 -awscli/examples/opsworkscm/describe-node-association-status.rst,sha256=wnuj65UEIX1g1M6CoYpl1jaaeUIiVyQRFISmkx8nFTU,838 -awscli/examples/opsworkscm/describe-backups.rst,sha256=szRbja4GOVIKkBv7z6ht2tKy7H8FvIBGvZUHntoU0QU,1703 -awscli/examples/opsworkscm/delete-server.rst,sha256=tRGd9xsEDL6ohx6T8yWtmGOiZ4TfuBEC8JPpfsKMxXg,603 -awscli/examples/opsworkscm/associate-node.rst,sha256=4W8g1K6-hEpSWv4UjlbgpQBLSNlhw6KRY_3P3ECic84,1108 -awscli/examples/opsworkscm/create-server.rst,sha256=6mOIZrcHJqbpVXIixnYHcgdZMBI6qtO4L1yjlXXRgX0,2229 -awscli/examples/opsworkscm/restore-server.rst,sha256=slNOJXxcumim7J4asXwIG4e4Hupd8NH8YbOnLhh4YAg,842 -awscli/examples/opsworkscm/describe-events.rst,sha256=YYF6JD0OBtM8xlmkWErx3IHG8NEXbz6cHWNcyrGf_Ag,850 -awscli/examples/opsworkscm/disassociate-node.rst,sha256=ApWB_MQ444G9yLJhHB3cHPEQdyEA11nE-EO1bvCymlQ,922 -awscli/examples/opsworkscm/update-server-engine-attributes.rst,sha256=M1Q1rgbzU5Apz71lTRyABfhr6RsRSWwg4CqPjHk_QAg,1880 -awscli/examples/opsworkscm/delete-backup.rst,sha256=tNxaxIBj38PCWvHPqe5mNWCJlORYU3OJRknR330HUdE,746 -awscli/examples/opsworkscm/start-maintenance.rst,sha256=AYLgiy7Il39bKaV41rbJ-o59aDbmOpQ1iQHt25xJhYk,1791 -awscli/examples/opsworkscm/create-backup.rst,sha256=m7W6GboEVzC_lFZ-2peDkNtyZAARsJ3DguvWGtvMwFE,1864 -awscli/examples/opsworkscm/describe-servers.rst,sha256=Tugm9EtUyrJUeOjPGmDrMQ7jdqABcIIXPU3VI4uTQ44,1715 -awscli/examples/opsworkscm/describe-account-attributes.rst,sha256=YrwPPjh3rnalXuYlgwF_0GudHfTywlcmpVjSiIq_aeE,723 -awscli/examples/pi/describe-dimension-keys.rst,sha256=w2_haUxgUHjmN2y8HUPr3QOunYrLNrHuVyzsJ4qPJmc,2050 -awscli/examples/pi/get-resource-metrics.rst,sha256=mEHM-1CDR3LgEe87JTc9fqCa6ORh_RUMGcWCetJirz8,2113 -awscli/examples/events/disable-rule.rst,sha256=QYuhPeEhSjDcUVZq86tvABhGotmBClSrB95IBboiBOQ,181 -awscli/examples/events/test-event-pattern.rst,sha256=Aje-MkToYwPFPi461t-IuILSuH8KmkaW5nMrVvoRaUE,479 -awscli/examples/events/delete-rule.rst,sha256=Ih09V2oOhIhKa_xaJ9qsvqRuFVP6sJIQgnVDFkkG-zk,161 -awscli/examples/events/describe-rule.rst,sha256=oacUM1RmU4fiwC-M_xTIutNhfmQ9va0IjeuRXCpAAIc,193 -awscli/examples/events/enable-rule.rst,sha256=vVit43JMxrEZlj1hH-q27JUQLdHnH4UMpL0Avsf8aMw,189 -awscli/examples/events/list-rules.rst,sha256=T_ICiBe9l-eASnjwEQvo5G-XhvTXyzf35oNAJGtIHxE,381 -awscli/examples/events/remove-targets.rst,sha256=XxH_wf3f1YoKiCIz1VXp5E08rQNoCXxJEOhMantoOOA,321 -awscli/examples/events/list-rule-names-by-target.rst,sha256=IHalXJVONFJ4N_lYtG1Yv54XXmz01r-SAYWGNSfofQY,277 -awscli/examples/events/put-rule.rst,sha256=9egt7KN3ZisZZIttvDpKJV3eBmdPacHEsplT_eQ_gbI,1067 -awscli/examples/events/list-targets-by-rule.rst,sha256=uaFo264bYAZed0ELaDCZsodpZzdo_YUVYt07ICJJU7M,204 -awscli/examples/events/put-events.rst,sha256=tNtjvDg35D17p1nS6VsdHsXMVEC8h37CMMZ3awXWwxI,739 -awscli/examples/events/put-targets.rst,sha256=-MLxWqIOlWwmn6cs8kME-lxi4uNbO8Ppk5-N6hmdhdw,999 -awscli/examples/cloud9/describe-environments.rst,sha256=1lMWilpFYQ0I6of3KS199YI3ISQPDJibC0zruP9zuxU,957 -awscli/examples/cloud9/create-environment-membership.rst,sha256=WA0mkqXvuzVjm_UHbxzTCpXjM6_jqjn4gFtrLwKOjxg,612 -awscli/examples/cloud9/delete-environment.rst,sha256=Nen6FEnX1CbIfTCw24dJ-dn6D3mAjm16V9T_vgRPEvc,325 -awscli/examples/cloud9/update-environment.rst,sha256=IYyC84MTJsdIMCVovI9tfuIOxPpwk_eya_hkTTamVt0,389 -awscli/examples/cloud9/describe-environment-status.rst,sha256=sXTYH-RD8vENT4qGQVs_yPrYKVE5WOHdSV96ml4-RuM,353 -awscli/examples/cloud9/update-environment-membership.rst,sha256=X0BS5QruU1ecBUNGFvlHSZYHZLMHSLWet1XUqQv9lP0,668 -awscli/examples/cloud9/list-environments.rst,sha256=GzpGzdgSaVhPaHMEi0Itt7WiWHYe5ZNZRvgBaPQi-UI,339 -awscli/examples/cloud9/describe-environment-memberships.rst,sha256=Q8m5czDqEw8K19U7LiycnqkQZ1OR4FF2kX-f4ikAJmE,2248 -awscli/examples/cloud9/delete-environment-membership.rst,sha256=IZ3IorsWXJK0LDUKeiv0i2d8OwRzMjCoX19OFrABORM,370 -awscli/examples/cloud9/create-environment-ec2.rst,sha256=vvECKnZzpm0-wcTBb3U9oY9xRA8Xi25KqnI2MQOt3aU,604 -awscli/examples/kms/create-alias.rst,sha256=U4wuWeZL7gRd3q4JFoULQd17bd0b3udAHw2tsjJcT8c,412 -awscli/examples/kms/decrypt.rst,sha256=MVDEGTHecx6pOQpSp51-XbWFWxH4ALz9YhpXMG8iwPo,2681 -awscli/examples/kms/encrypt.rst,sha256=GEziv5EXjXHqYJBalmO6r79arUAufzvWg0pqWcsdhzc,2792 -awscli/examples/cloudsearchdomain/upload-documents.rst,sha256=SD6lp4cgtsvBZnVYqHbLT9_2UpQnkb3Wwrq6OPbsfmg,375 -awscli/examples/emr/delete-security-configuration.rst,sha256=ZYF4Mobofm9f523XbIWDOVqE46mW3KNoqAfEfMTTHmc,173 -awscli/examples/emr/list-instances.rst,sha256=1Zm519juyG7pJdB-Usej0Cw3CKHcFq64yzpUMGVAWSE,3267 -awscli/examples/emr/schedule-hbase-backup.rst,sha256=Ix6iETAh17FXZA3U0buVqqlN_3I8ehnLCK7nLTs2AKM,678 -awscli/examples/emr/add-tags.rst,sha256=h35saPb_5aiRrzpGAyYsGQp8pDmd002-ouKr2sMOsck,648 -awscli/examples/emr/add-steps.rst,sha256=OxGtOx7u2EplNbCpMTHgXKEwhLGH3BZWS7nJXi1XQEE,4477 -awscli/examples/emr/describe-step.rst,sha256=NB3J-O_zmCg-vLPnHVmT2jG5H-_QikVS8cuSSH9FrEw,1146 -awscli/examples/emr/modify-instance-fleet.rst,sha256=ALpqFseE8NRMIcjITkaqgLur04ET_aL_WYWCmNI8D9c,333 -awscli/examples/emr/ssh.rst,sha256=WQekzXNmybA0IDqJr_1CVqMrCdAI97korEgDg_jKMLk,1462 -awscli/examples/emr/put.rst,sha256=WbwN3DGk_Fk0mc6Bw6LSJ7qbHjjmelCn0VRXCjcI-7A,287 -awscli/examples/emr/modify-cluster-attributes.rst,sha256=FCCR6voI_KjVHKvJHpKQ7h4iROxSZly2_44moaHFctw,196 -awscli/examples/emr/socks.rst,sha256=VowwnmJ--TP-6uqLAWSex6a5RgjxynFjpffHJ8Mjqgo,273 -awscli/examples/emr/list-security-configurations.rst,sha256=G-njgyuYo-C2Su1_i43TrUUe8Tj5zfPOBKuuZkCHh1g,357 -awscli/examples/emr/create-cluster-examples.rst,sha256=a2EaTCqyuQSaGnDcSfnjYBC4g5JqgKVlGCoF5WPC_Ko,25333 -awscli/examples/emr/list-instance-fleets.rst,sha256=4PdyixWT-CrwZ_Sb17oPOW4Wc18MhZMuv2PGc-eyVes,2031 -awscli/examples/emr/get.rst,sha256=Isad5KAO_0juOb7qVi8Y8z2X3QQQHQury9L8GVIiZ5M,258 -awscli/examples/emr/create-security-configuration.rst,sha256=m3vxwRSYxuDRoIB33gFXxoiD03JKccb329eiE_K2byc,4003 -awscli/examples/emr/list-clusters.rst,sha256=BQ4VzVS2Zev-pQEYwQnY8416kk55Dr2i1qnYbriCLXE,670 -awscli/examples/emr/list-steps.rst,sha256=iilOrfJ-XYIbSshLrLqnC-DzmXE6twP6HFNiGqJ301M,151 -awscli/examples/emr/describe-cluster.rst,sha256=9qgm-NcXLpI2CCyceVM6m2IAuX327Xvziua_YyBarOk,9595 -awscli/examples/emr/wait.rst,sha256=7_8mKpPGeFLN8lqoDEJ4SgFubM_ziiV4aoIQU8GRX7k,165 -awscli/examples/emr/create-cluster-synopsis.rst,sha256=-XFC0Uy9kKyEpBe5zdpzvuhNGUAMPRoEpik_pIgaQoI,996 -awscli/examples/emr/create-default-roles.rst,sha256=pmYwkYa9HgK5Qn6VBFSL5SgWbyV9jNRDNmV_wE_TdKA,5688 -awscli/examples/emr/remove-tags.rst,sha256=e1iKW3cyJvhc4PAKxoMgGoK0zN464ORXN5z-oj7zMRg,184 -awscli/examples/emr/add-instance-fleet.rst,sha256=86QceC6G-Xg_2SokLSEhO4rBpvSsh-X3w3OB27jdFx4,521 -awscli/examples/sts/assume-role.rst,sha256=vu-jgl4ftzp4KqDUdqktayKntQJ751VogB2Ix4L-0U4,1430 -awscli/examples/workmail/disassociate-member-from-group.rst,sha256=3g8leVoHnbQSXPePLS1ADx9ZjQ2UVxxwFt6V7C84-5g,348 -awscli/examples/workmail/describe-user.rst,sha256=f9amHDpyvBXbRGJthMHkOhy7aANa4-lLxbGWtSge1As,521 -awscli/examples/workmail/update-primary-email-address.rst,sha256=SOOI4DEd2pOlFUCLtqorIkPX2ziFLUwM3MgB6sbhtZw,371 -awscli/examples/workmail/list-aliases.rst,sha256=MglONpgJ-BtJ7Nfqip1Vp7lskB2Yh-z30gLQyhIBPkw,393 -awscli/examples/workmail/deregister-from-work-mail.rst,sha256=asuNd8z_scvhP4srnlIgoacMC90PeguhNPI5-vGLZv8,323 -awscli/examples/workmail/list-organizations.rst,sha256=5rWHiiU7xJBiTIthvIpwHn46rWcYNDnR6EFZbMSzRpE,378 -awscli/examples/workmail/delete-alias.rst,sha256=8JzH61WckV5SUr63AoiZbgReguz9Z3ia20ne8O-p9TE,314 -awscli/examples/workmail/delete-user.rst,sha256=nsR297IeGekfq1d3BOfJWzhzCSQx5atPOvWEPs1WPFw,287 -awscli/examples/workmail/list-groups.rst,sha256=AcdPPAcAd1fDymZigKiHqb-YDDSeqyb-makZvpyScs4,584 -awscli/examples/workmail/describe-organization.rst,sha256=vWw4dGo6nyA0F68bADmsMWeOK0wsndqkanP2WgONZGw,545 -awscli/examples/workmail/disassociate-delegate-from-resource.rst,sha256=urhREMgtuvn9oy4YUoTUUhzYtvB-zvVidhXXZbqPBN8,350 -awscli/examples/workmail/list-resources.rst,sha256=_kTud3ehTi1jTkV9Vt4pB1Mf8prS0EUEyDW3CwEY1U4,436 -awscli/examples/workmail/list-mailbox-permissions.rst,sha256=stB4oMqXypQEcMyurA2dEeQTLfgj3sW2yczvn6hdIuY,580 -awscli/examples/workmail/reset-password.rst,sha256=2h5M_jjOQ9JxVzsiotrLE42xQx7nh0bQ7bp8QB_GdVk,288 -awscli/examples/workmail/list-users.rst,sha256=ylJfnkjP_MGvD93QAda7X5a2cH03oz3gHm3fnvlFaiY,740 -awscli/examples/workmail/delete-mailbox-permissions.rst,sha256=jw0KqSD6GYMJXEYmYbygSsdvZpGLYtgHZ0gqJe5o_Rs,509 -awscli/examples/workmail/describe-resource.rst,sha256=IdNHTtuLJudA3-mk6YE5KbuJxgrNLAINWdOFDk3vC8Y,578 -awscli/examples/workmail/create-alias.rst,sha256=ngfoUH8-UNgAIPUBqmUyw8-EJbkbuUSzBhrbLswGI1A,313 -awscli/examples/workmail/describe-group.rst,sha256=ERKYP9tayN0b0jQhHp6zQAOJuHzeKmt6yR23BcSzV-A,403 -awscli/examples/workmail/delete-group.rst,sha256=L8xM0i5IupY9wfnvBiiKuhs0Lxc5fdfE-k1K54AkyYA,274 -awscli/examples/workmail/put-mailbox-permissions.rst,sha256=KprHogGJIcUf01fjlWkRvOXVi5BCakANky4Jwc3IcO8,447 -awscli/examples/workmail/list-resource-delegates.rst,sha256=DzMYEf0FZzRRF0Sax1zhpSmlswWa2J2d3-y5nnFniwI,446 -awscli/examples/workmail/create-group.rst,sha256=YoPo73lqs1_-JhQUZe1lRpoDoYxel_637qYfSC61pcQ,300 -awscli/examples/workmail/list-group-members.rst,sha256=ziSPEfUDDHBtbPTo_BCEOxFcCyHK092OV1bShNqmiB0,525 -awscli/examples/workmail/delete-resource.rst,sha256=xvqDWjKxnSua-iAk3SqEA2Y8bcx9o9njjj3VrPlbShs,272 -awscli/examples/workmail/register-to-work-mail.rst,sha256=xCWJTtHH7rgrfT2j65OO0o4S3tktigYY--A2PXcm0CY,366 -awscli/examples/workmail/create-user.rst,sha256=IbAgTlS3CC6oOf3nF_NfvAiQzNHsiB7U0isdFO9F5EM,324 -awscli/examples/workmail/create-resource.rst,sha256=vTa-n3pi0tfcGAxl6B_NB7qoHjSdQXLmpL3nv_9mLwk,326 -awscli/examples/workmail/update-resource.rst,sha256=3VSSzjGRugv8War40WIDPebaxq7AaAbFZ4zUvW-NInE,277 -awscli/examples/workmail/associate-member-to-group.rst,sha256=Jp5alRCyJVAxVNBYYtPEES_SPTSW9HkSZUAQ2xjgw0Q,334 -awscli/examples/workmail/associate-delegate-to-resource.rst,sha256=wQzgrJnq1PFONhqTiS7HlmUgLqEuLOHt9Toal8H5j4E,327 -awscli/examples/deploy/add-tags-to-on-premises-instances.rst,sha256=GcAuPTmp0uTTPrXGu4x81GkeXlVjnujt5pLWQlZQ12g,419 -awscli/examples/deploy/list-on-premises-instances.rst,sha256=k5Z_q7LhC93lrcQa0pCMDckApCIAYfhIfeDMk4vtFOs,511 -awscli/examples/deploy/list-deployment-groups.rst,sha256=jKo8isTwT_SxgBWMcIQNQ1L63Ste03cAh50v83frTM4,389 -awscli/examples/deploy/list-applications.rst,sha256=1AaO9nw5iNlHlWY9yEcDoEbeBPOfFYr8AJVpDAMzHIo,293 -awscli/examples/deploy/delete-deployment-config.rst,sha256=fUA0CqGcBxXihqvTnXRbGrwyrooHGhX1fbB1DNmzJKY,259 -awscli/examples/deploy/get-deployment-group.rst,sha256=bm9mdRa2aX8U_wo6bC9l9roXVedyy7mkz7r6YvtInn0,911 -awscli/examples/deploy/push.rst,sha256=rxVzniTA2qzOZ40Kf5lQF1BpBiL_S2UKZLE7HtXNBtc,928 -awscli/examples/deploy/delete-application.rst,sha256=tC-Yrk0TxRrXHIgop0HB62WVOaG8PVLjK8HCPjkMZlw,209 -awscli/examples/deploy/list-application-revisions.rst,sha256=DsYn-DQdy4EVmor9sTQjyH4P6ZKl5qD9GC28XZnViFo,983 -awscli/examples/deploy/get-application-revision.rst,sha256=_4NZPxa9RvMGimQmbHgxdG6nE6wfGNAVpsfwCFP2QNw,975 -awscli/examples/deploy/batch-get-on-premises-instances.rst,sha256=ansCUu9mUpm8_8UUc0wYlZjQwWuq650jamuSEyTtLdw,1133 -awscli/examples/deploy/delete-deployment-group.rst,sha256=IGpVdQos4w9JYs0tpMi4gHmQ8QI0Ik8T74ydJJTH8TQ,292 -awscli/examples/deploy/update-deployment-group.rst,sha256=4wcpEecFO-LgGVUWLdJfOnSmoebcAPTp68-Rq7oUW2M,588 -awscli/examples/deploy/register-application-revision.rst,sha256=_9N3z8GukX-p3BYhhIRnnF0zn0lGtAXLNjZioQYsjUY,468 -awscli/examples/deploy/register-on-premises-instance.rst,sha256=NBF2QiT36eo5Kqz9bVtv2bcxh5lbtK6NINNZXXw5dko,460 -awscli/examples/deploy/uninstall.rst,sha256=6K19DHJwd5WwrtDbB4QMNhUiz8HdcvsyNbm9ES8jXeo,473 -awscli/examples/deploy/list-deployments.rst,sha256=HIjEkkZmtbZuYrr7exeJmTzwShbGq5XEiosObGNKMqk,507 -awscli/examples/deploy/batch-get-applications.rst,sha256=ztRJafpzvtSciV90PyYCCu5Op3aApvKiqGx67wBVcow,745 -awscli/examples/deploy/list-deployment-configs.rst,sha256=b013fhss93RZ8UK8lnRB_ZQLmY16txT-MLSt2ds9oG4,442 -awscli/examples/deploy/deregister.rst,sha256=59EWt-0kPhOPZOpyo_0TuaWnBt75Xse-JE2VwyU97HY,904 -awscli/examples/deploy/get-application.rst,sha256=KFduQsF4RJ1GwrHXeHyM7cNHB4ZHeLGqYfMU8bS7uwQ,452 -awscli/examples/deploy/stop-deployment.rst,sha256=fjiImd1NXXsYUgrf2Y9ap1EK7q6kBNPptHGMduGqOQw,360 -awscli/examples/deploy/remove-tags-from-on-premises-instances.rst,sha256=Dzciqgcm3_qh_fkZxfXAPgsicCgqPMwR4rZkI27MxmA,641 -awscli/examples/deploy/get-deployment.rst,sha256=we4UYZJaFAK1bpTTLvfJlNcQhOZuAZa6S5K7Zr5r_JA,1175 -awscli/examples/deploy/get-deployment-config.rst,sha256=fGtSeahpcZvpfkLFJhhaOL8A6fatA2WN-XLQsKlbxME,605 -awscli/examples/deploy/create-application.rst,sha256=hO9KvonFCpHCDM1jNKHetAdHWrvRnhfkZI30sC83iQU,270 -awscli/examples/deploy/deregister-on-premises-instance.rst,sha256=0DJaRmQw1YBiOPootIewx3lZ8rmwJZBosNmm2HeqIiU,543 -awscli/examples/deploy/get-on-premises-instance.rst,sha256=6CQffYHZqPAfrkPe2flh9FbV7lE35dhjUNgNDrk97hk,651 -awscli/examples/deploy/batch-get-deployments.rst,sha256=iRDP66KYVbiMgBBbitlZCCbXRmFSJ6GdYu09pHB3a5g,2361 -awscli/examples/deploy/update-application.rst,sha256=0JJeOn43Rv_T4T89UTKfxrSY4wilFM7DkvmDHoLT6e4,279 -awscli/examples/deploy/create-deployment-group.rst,sha256=aZW2TO_siKcTFXyMYeJizeERYxvPufp-e6n7Yx1XkUA,585 -awscli/examples/deploy/register.rst,sha256=Y1oLVQfJ_4EHMKUSd2u68OUgyRbb4Z7Gu0BisnzlQqw,964 -awscli/examples/deploy/get-deployment-instance.rst,sha256=cQd7OkxKxR7vw38J7BVwPD5ieRSOmDE8IKiCJxW0uIU,2009 -awscli/examples/deploy/install.rst,sha256=WLNtgTgEBbhnzN4rDIyIqHTBY_4dqhtJk_cxrxUjiEk,766 -awscli/examples/deploy/create-deployment-config.rst,sha256=P3eWbUuX8pnJoZL_rz_qR7NYN26SugStSZj72yX26UY,384 -awscli/examples/deploy/create-deployment.rst,sha256=7F2Mx6Mus8u7E45NZhvCO9Tc_Fx0rZqf_tBVjp25_lQ,481 -awscli/examples/deploy/list-deployment-instances.rst,sha256=hUoLswzuaqNIqrdIt6I2VZtK47uXWWCdy3fFw3QGmoI,372 -awscli/examples/workspaces/describe-workspace-bundles.rst,sha256=B8mK1w-W3jKo1PuzRM2tirBvA9Wi7SFiQzKa20iT4J4,3556 -awscli/examples/workspaces/create-workspaces.rst,sha256=WTf-ke8Z7zDecgScIJQ7PHpTcVHm4VCs7LQudXyxPns,735 -awscli/examples/workspaces/terminate-workspaces.rst,sha256=DUi8m7nKbB50foCe5x4FT1O_DNA3sQ6AybrKgQ4wr78,217 -awscli/examples/workspaces/describe-workspace-directories.rst,sha256=XuU6YLrNjCgQ8rSFS-FBiX5dpbusyCfZXSqBkElSS9M,1755 -awscli/examples/workspaces/describe-workspaces.rst,sha256=zXXWJMdlZwd9-lmkgDfXRylm6F3m5Gj0QuaoN325wHE,920 -awscli/examples/dlm/create-lifecycle-policy.rst,sha256=nb72qKYDj2zOUminXp3aIbV_fzgbhlS6ZPQhjVgFg1Y,1336 -awscli/examples/dlm/delete-lifecycle-policy.rst,sha256=tEY9IcT2CGb9YIYIQqlmv5GEHuRH43wig4E2jsK_t1Q,170 -awscli/examples/dlm/create-default-role.rst,sha256=sdtn_ske1Q4Gz5tqr_dZGpEQg1Wrs0F2oa8EOVqSNvw,323 -awscli/examples/cloudfront/create-invalidation.rst,sha256=c9vKRK2V2rLjZpxH_QF-UhpqcrSnJNBo6XSe7Ac3_RU,1525 -awscli/examples/cloudfront/get-invalidation.rst,sha256=hg0Rt3P-oQ5SyB1A5nBDu28Rty4ZaIPbYWIRm_san1M,913 -awscli/examples/cloudfront/delete-distribution.rst,sha256=B4Oz1THx4KLax_tsPglhGlqVFQjN-8EmLEGc7v_Opbs,528 -awscli/examples/cloudfront/create-distribution.rst,sha256=MSN6SxFvfFUtDFZAxborx3YVWS3Mso9Hx0CrupyczEU,4901 -awscli/examples/cloudfront/update-distribution.rst,sha256=7IAWNxAvmkVBz1Sfj7kkHxfgPgUfWbeewXsCk-HTnCc,6343 -awscli/examples/cloudfront/get-distribution.rst,sha256=GKT-9nQ9lhBC84v1Th7nfSL-iSOUWr5otqjXgW5J38o,3379 -awscli/examples/cloudfront/list-distributions.rst,sha256=TIBYEw-8hcYtOloNFsvsxQie0q141E-vG8FE64fjIU0,3297 -awscli/examples/cloudfront/list-invalidations.rst,sha256=VYyCF9zJyA4GWZPwLvxgYVH35qEGnhZeKO9neJfwnVw,666 -awscli/examples/cloudfront/get-distribution-config.rst,sha256=JQessEELN9LTIqzeyEznEGtNS6lp8QqEPALxeBLkxhc,2733 -awscli/examples/iam/get-account-authorization-details.rst,sha256=khD0NEGn8asKOGbIhES6WHfqeC57j8zrzQDO1TjfLOs,8896 -awscli/examples/iam/upload-signing-certificate.rst,sha256=Pe845cmUuNQXNF04vW7eAevTJG8TLpZ0nEm_IJgZEAs,898 -awscli/examples/iam/put-user-policy.rst,sha256=5Lk016C0NXyOX6o4qrNOiuSuyPvbGa5aczR8HAB9ID0,592 -awscli/examples/iam/list-mfa-devices.rst,sha256=EJoPUVhwbCPPTmbYiLCc3OKHDmBybU2hpUZVXJGZMD8,633 -awscli/examples/iam/put-role-policy.rst,sha256=fA1CPrB7loiwcBULrJ65OaDfvB_BZEAPg0icWATNYoA,650 -awscli/examples/iam/list-attached-group-policies.rst,sha256=53MeJhHYRKonFZ9-V9Pn0PX5btobxeiGs7ZF0HLGOOQ,778 -awscli/examples/iam/list-attached-user-policies.rst,sha256=kE3-0C6FfqOdsBcR1V5Jb5HVB_RTK2ovHIk2bOvBTpo,751 -awscli/examples/iam/get-group.rst,sha256=_mxxI6Wx8aVsWaOvUqsOEIfFPvHtegg7AhqkyaackXg,586 -awscli/examples/iam/deactivate-mfa-device.rst,sha256=iwS34BMKlTQNQibukqjg0Xkz8vJEXBb8OgfWh_Ot-RM,543 -awscli/examples/iam/list-access-keys.rst,sha256=wnM7pDnDZO7RLQMsyo-2vIm6MlzqfcldQCXe2xuvKRo,1003 -awscli/examples/iam/get-login-profile.rst,sha256=SiBPF-gYMuPuhvFbbAbVkalZedqbMpXcKshR96_TIYY,970 -awscli/examples/iam/delete-account-password-policy.rst,sha256=XTAkhYYWdx2CuIdyT4cE-5f7cQdUXMwZJltNzco5Dxc,419 -awscli/examples/iam/list-user-policies.rst,sha256=GqltNnbe5PW0Zz1klbv62oPPk2SVJZnefphRgyNCf5U,492 -awscli/examples/iam/list-virtual-mfa-devices.rst,sha256=7_UwElUT0cMdjBKEwRgZehSQ62EHzk9EMus87RQ2P-c,628 -awscli/examples/iam/delete-account-alias.rst,sha256=Uybw5iDdEEeDP5KHW41xukKgL9y55gcPUw-h99TJnhA,403 -awscli/examples/iam/resync-mfa-device.rst,sha256=xdFgJ4c2aw3JteDff2y2TVrgjMetApKcjT6kQcrLdh4,705 -awscli/examples/iam/remove-role-from-instance-profile.rst,sha256=1hjbwAcxvqPWMs-ZMBNkTjFKV_qF7QwZbgbCUgVIuCM,491 -awscli/examples/iam/create-saml-provider.rst,sha256=nMGCkQVSkWJwj7GXOZbHTW28ysD5Ha95BAuUqfhVl6U,579 -awscli/examples/iam/update-user.rst,sha256=4Vjouqx3RneCFqlowWX8s3_5Wc6usWOVV8EuRyLa3HU,393 -awscli/examples/iam/delete-user.rst,sha256=5nAQPaFUEjIHOiuh6ZgPi5CEE45sDsh0rdeS0IdjcEA,390 -awscli/examples/iam/attach-group-policy.rst,sha256=L2hIJ7X34nnND8b3CB7IG8diSUC265r9cKHeUCDWIYA,509 -awscli/examples/iam/create-virtual-mfa-device.rst,sha256=pwdV0g2DgixFOLImaWlzCsAdonpP6X1a3ukjJz865os,784 -awscli/examples/iam/create-login-profile.rst,sha256=L4n-SfHz4MHh5EHzB38qkznw_fFAxkBnS0x1ljpu3n4,2139 -awscli/examples/iam/delete-access-key.rst,sha256=1CNatpsJ6QRf0N29nsooQ5NYgdCNvGk57jkJxvMT674,620 -awscli/examples/iam/list-attached-role-policies.rst,sha256=15z_r8aaDyXas9lRCdb4mweYngDifws9cJHDN5gcFYA,659 -awscli/examples/iam/get-user.rst,sha256=9J89QxMk-wGREO_2JsAeC1K1d4hdYoEW9rlc0M1nUDw,574 -awscli/examples/iam/remove-client-id-from-open-id-connect-provider.rst,sha256=TX8ENjaWIN565E7-kN9-xiP6q5pQ1zwtuSO0Bznl8HY,727 -awscli/examples/iam/create-role.rst,sha256=2s7qrTcyDFgNsLte5QX3GEAJjDYbWY4avOUqdKQQB8M,981 -awscli/examples/iam/update-group.rst,sha256=AXcEno3ptOnd4KiCMumX1UtwGs7rAvYI15GA0gt_pVI,394 -awscli/examples/iam/list-groups.rst,sha256=ClWoa_KWciBmF3E6cWmBCZLL91deBVvIINqeumtFwqU,824 -awscli/examples/iam/delete-saml-provider.rst,sha256=02sOz_hlUBEHOnHCQ6A_QCtOAaEMvxLrcz4yRpPJB1A,446 -awscli/examples/iam/create-account-alias.rst,sha256=flwKeCamOt2Fe-WhemIrqFpZywFADVNc2dxM7YYlN9s,394 -awscli/examples/iam/add-client-id-to-open-id-connect-provider.rst,sha256=h20-9f1716ovMLrAG_iXZqJ2p9BzEPj92SoZs_UYHbE,709 -awscli/examples/iam/delete-policy-version.rst,sha256=rU5ZCYJSdy2OIi_bqpUtH8iwJQOFVIDqNk3V96e3P_A,471 -awscli/examples/iam/list-open-id-connect-providers.rst,sha256=xLCkFkQi2Gm8_zWOACTOM_CYVr1-W_mcOdaZTdLt6JU,618 -awscli/examples/iam/delete-user-policy.rst,sha256=Cgx9psIJ8CSkHj0-qzRX5LAGNPLTs7a7fcSCcDGa_fk,525 -awscli/examples/iam/get-user-policy.rst,sha256=hKpruvr5Gyuq0BvvMBoXpODMhGLwslk1yZHR4BbkPQ8,873 -awscli/examples/iam/delete-instance-profile.rst,sha256=nidP8p324EWXna0R1zTFUl3j3VjZmvjkrazzchFzctg,403 -awscli/examples/iam/delete-role.rst,sha256=L1wmZLoElwB_o9nPAxCRb6t83j03Qw3OmJQ15WgwwS4,696 -awscli/examples/iam/update-access-key.rst,sha256=iidGMRKCIHBV0jXC0C8mfRr48kdPo4-2G6iGuKtmXak,715 -awscli/examples/iam/delete-login-profile.rst,sha256=obeqrGJoz0PHMcFfDJ2X00YZYNWO2LQiv44Ec-o4K14,369 -awscli/examples/iam/delete-signing-certificate.rst,sha256=Ae4_rw60_ayFyUww7oy2SyAFuB6_Nfc1TGIK2PECr7o,612 -awscli/examples/iam/upload-server-certificate.rst,sha256=HPXIVzAmW1WIr-ZNdTUzfOvUuhLpJyxA32-boXJZY4k,1166 -awscli/examples/iam/enable-mfa-device.rst,sha256=AJp38zvIoh11g2R-wePStf4JlPNJ2i5r_y4TIkM7mcM,803 -awscli/examples/iam/get-account-summary.rst,sha256=U0KVRx57G_SF5P_EJA9HBIjH46CZdFn2EYxjh_Q-9Ig,1285 -awscli/examples/iam/list-users.rst,sha256=N6EhnqsSbBxD_k-MVcvO-As4oKK6pBnyc5fnGnKueZI,755 -awscli/examples/iam/delete-virtual-mfa-device.rst,sha256=eScz59h-uzipuoWRMm78AnG6L_5dy5w2UBaALtY-QXw,446 -awscli/examples/iam/create-open-id-connect-provider.rst,sha256=IDCuQ-g0dFjm4-frkg6MRQB6AHFy9hxGUeuVX_rG0pU,2405 -awscli/examples/iam/attach-user-policy.rst,sha256=zpsp1f735LQvddcd1F91BcXuEynDzLG2ssqTUU21_wU,510 -awscli/examples/iam/generate-credential-report.rst,sha256=RhhcwObzwpSEGa19q8XSog7mgK4tzP9ojLl7x5IEEls,513 -awscli/examples/iam/change-password.rst,sha256=3dEjkFxcpIRTq2JGglUVelCpzldhIwIXysZe68vztg8,1641 -awscli/examples/iam/update-account-password-policy.rst,sha256=UTLuXWqhviRakhaEsU9d8tkO1089FS5wrv-PnKHcEpk,749 -awscli/examples/iam/update-assume-role-policy.rst,sha256=bX-gabO4pCbulafni2-5EJmeyBmmdSkruuAk1Rj027Q,710 -awscli/examples/iam/add-user-to-group.rst,sha256=IN6vnwCLZ_YUgXJH2SpOFMIJH_S_YhxRbxV3Fnr_H48,445 -awscli/examples/iam/get-credential-report.rst,sha256=kLRXC-am-ZRoi4fukXqXNc3rClwiiTWKX4AgLaItuKA,491 -awscli/examples/iam/update-login-profile.rst,sha256=YzPNh53nk2IXliyb02skj35fJgJAKTwViMtyIQ9U7Ew,895 -awscli/examples/iam/delete-group.rst,sha256=FJ2bHQrPJFOQKGvhURFRZ_YGgYlMBUUDZ7g0AQJlHcQ,340 -awscli/examples/iam/list-entities-for-policy.rst,sha256=9KcJb9MeaPCXKn75xwEOXVMp9kEg19SRc1cB25gcGsI,772 -awscli/examples/iam/get-saml-provider.rst,sha256=KcPxzdb18WmYinImV4-f8apar87IuPMiBqfuxUD4_sc,632 -awscli/examples/iam/create-access-key.rst,sha256=N2Ud00gMxexjpkayCVEzQvQiKGgRpPlLBjAeI_R_dn0,842 -awscli/examples/iam/update-saml-provider.rst,sha256=QxtoAaPmSxKNThehSSN3DSx32Fyly2AhPmg_Biv7ClY,676 -awscli/examples/iam/create-group.rst,sha256=4ljWhd3tSTvv7ofR8wFWz4FfDtzRLxHLYRzXPOS8AGk,594 -awscli/examples/iam/update-open-id-connect-provider-thumbprint.rst,sha256=yAKaqpec84aY4BavQ_4h9JttfZaRUr7hq4GZUIglEZI,698 -awscli/examples/iam/list-signing-certificates.rst,sha256=dJ6cd4Gz07WJMJ67T_NcWXGQ-a_dYnTrgeBI6n0BgGI,788 -awscli/examples/iam/list-account-aliases.rst,sha256=yG-NLR-3MaEpoygjwmh7cF5Oc-fi3dR5GVH_C3cQ7mg,414 -awscli/examples/iam/delete-policy.rst,sha256=OAAQ-8gWQGVPeFfuLeMh501IlWYSnNFj0_Zdtbpxez4,399 -awscli/examples/iam/get-access-key-last-used.rst,sha256=p6WhXRwXc2f9Ov-cJTE75pM9A5_23POekUzmoJyv-a0,636 -awscli/examples/iam/create-policy.rst,sha256=d0N5DH3KeibeB0u19QFzjp6PnmNQgCJJw1hd_a4bQ2I,1300 -awscli/examples/iam/delete-role-policy.rst,sha256=I3Gwu0oMEdvw7XBloSw3xLzXDM6bvanVPk_HuqBoZtQ,409 -awscli/examples/iam/list-policy-versions.rst,sha256=3TSgqHudHYr7X7BHnm1Gcf7UgMPdFRAIikJpKwGIKOk,802 -awscli/examples/iam/list-role-policies.rst,sha256=WOjVtqHH2gLrz_EGaKYTjUDhB2RorJdB36tjnibKZqg,597 -awscli/examples/iam/create-user.rst,sha256=k0QKUt-7myftRMC70eI08qcQpiskNXSJJpi8TPa60KU,622 -awscli/examples/iam/get-policy-version.rst,sha256=qZf_zWvp9yQW7zQujwdjqtdP7T4AIeyYdFOIjHCQ-uk,846 -awscli/examples/iam/remove-user-from-group.rst,sha256=pokPiBzrs93bjpvMK-6rowEusRHE0hdO5Y0ma4h14r0,474 -awscli/examples/iam/put-group-policy.rst,sha256=TUCKWqqxwGSD42Z2EpiVAcMe6cQe3WTtoYmRCmFnX84,548 -awscli/examples/iam/get-instance-profile.rst,sha256=e9TF2yCSCinK9OqZC7SyuEHW5xToaDd7kt9T1PX6MaI,1136 -awscli/examples/iam/list-saml-providers.rst,sha256=BY2F1d8OFl4BJPwn_tN5SIVte7uE43uk8pMNKC2__8Q,580 -awscli/examples/iam/get-policy.rst,sha256=HQYgqqZdEzW345nDpO_flGfJWH34jk24zGf4n30yvMo,852 -awscli/examples/iam/list-instance-profiles-for-role.rst,sha256=u_eNv0GvePu9lIXk2IdQ6wvF_3B6HkgUQwMemqJRrFw,1135 -awscli/examples/iam/detach-role-policy.rst,sha256=neijJcOPgSMQ3EpgL2o2fXkS3LExOcyM3IROMWlHf8Q,511 -awscli/examples/iam/add-role-to-instance-profile.rst,sha256=Q4x3BxfbS4L5qOrNBov7vqRYy7P8rh7ei_CQXabiNas,650 -awscli/examples/iam/attach-role-policy.rst,sha256=j1CLYdPr9Dt3l98wKCk-8asscizPx8v1zZN-1oPQAYc,514 -awscli/examples/iam/set-default-policy-version.rst,sha256=MvhohH_Z-O6xrd2CGNL80LJhzwBSSJF_MaDX0eQsV-s,527 -awscli/examples/iam/update-signing-certificate.rst,sha256=7wdyavieu8ZxP6wVAqWoynG82bB0rXm0GnzTrsKDdRo,650 -awscli/examples/iam/get-account-password-policy.rst,sha256=Y9iMdOAv0CIXRlmfbeCT0P2S90L0rbeRWEpn52HXHpQ,820 -awscli/examples/iam/detach-group-policy.rst,sha256=M4neS_D0bU-uIJty-in7ixZ6EI0NlXJerFjwprXFkXk,484 -awscli/examples/iam/list-group-policies.rst,sha256=Xml5dE9iV62YFFn8AZUpmmO7VGGMal7v86rd-n03ofo,561 -awscli/examples/iam/get-group-policy.rst,sha256=MfXALOn3_4pxZy1vrrA5jVfactS_cbSgvtQzrVb3f2Y,877 -awscli/examples/iam/list-roles.rst,sha256=WqgmpoNpj6pxrd3__7ZSZk68gU8YyWb3U3dv9GMTKF8,1491 -awscli/examples/iam/delete-group-policy.rst,sha256=hWNBqpHRO4PxMcvoaFQV0-slY9Qu9d_rNdaF5VYR6us,506 -awscli/examples/iam/delete-open-id-connect-provider.rst,sha256=1Hw3VkYHidf2pCa9rExER1ancCm1c6-coKIsuvJK0o8,526 -awscli/examples/iam/get-role-policy.rst,sha256=TZraxGQw8U7BSp2GRu_HF99C4e2Sgpun2-sbKxO6SyA,928 -awscli/examples/iam/get-open-id-connect-provider.rst,sha256=Y4_Ni4J3X-Y5ZW77MFhWgPI0jvwu7H-sU7S4PpaXUtI,808 -awscli/examples/iam/create-instance-profile.rst,sha256=VCPd36xMzldkFKHsVCi9c7Yzyx4sLQarYYvqSHOXib8,921 -awscli/examples/iam/list-policies.rst,sha256=es1rwuZ2FWb0Yoa2U6Fgm34nsM1dNQhEscULW26sdmc,1283 -awscli/examples/iam/create-policy-version.rst,sha256=PlwpkTM2Gxi8IGZRe5i_4oZcpOQRQggizQ6YIZiTc2w,733 -awscli/examples/iam/get-role.rst,sha256=9l_mLE8AZEN-Jrh_armmT0-FKGaAswhm_B7dMVg2liE,789 -awscli/examples/iam/list-instance-profiles.rst,sha256=rHIHjm9iNBsYzMRUKwOQYev6Kqa-AhYcJOcz-g8RHKo,2338 -awscli/examples/iam/list-groups-for-user.rst,sha256=eHjlRu6JSvNlS2j76Zpfrmj8j35zKNz50Hp5LxTotQw,896 -awscli/examples/iam/detach-user-policy.rst,sha256=wtyv0SCttV16vDggPjk2Aqeid2oavGLekWeUYE3ghOQ,454 -awscli/examples/codecommit/delete-branch.rst,sha256=Ch-StW1LsrXbnUOgxY4rBKOu-wxy0odDRp_ctLlKKd0,312 -awscli/examples/codecommit/put-repository-triggers.rst,sha256=Q9_9PNWr5z0oBp3984DYLAfW1RoH0y7MDdQ0B5Gfxqo,1277 -awscli/examples/codecommit/list-repositories.rst,sha256=WAQoJJQVrH9FcpbfVKmFKAJA7d3NORZkpzyQmk2Xoao,483 -awscli/examples/codecommit/get-repository-triggers.rst,sha256=4mIOpDEXNt9o4cwTViVLtAEipayleSFGsdEN1r-j7rQ,969 -awscli/examples/codecommit/update-pull-request-description.rst,sha256=0H0YqCvArF-tAd9Klw6FO5DZ61LtCBnQmLPs9cLsPL8,1113 -awscli/examples/codecommit/update-pull-request-status.rst,sha256=i8t2XDmlXrhfJaQcLAKVyup5-n1f9aXNadoLhnHQXh8,1140 -awscli/examples/codecommit/describe-pull-request-events.rst,sha256=hAN3_s4T1_t7WEcrOcbCbaqSAwCv4ioBrOTtU-M52Rg,815 -awscli/examples/codecommit/create-branch.rst,sha256=jJt4qBywnXG5EtT5htSbn2JIAjlTg7XCjmFcy2fjrQ0,287 -awscli/examples/codecommit/merge-pull-request-by-fast-forward.rst,sha256=aYWul9CiWeT9-MKwXOI45Rgj04O6UGtcARfZwbDfBOQ,1239 -awscli/examples/codecommit/put-file.rst,sha256=u_ZfcrSq4mNvuDxJltfHiKeD55SYGMHJelVPhu72x4E,720 -awscli/examples/codecommit/get-comment.rst,sha256=R2a979XXnY_uCyf8dHJv-xhiAETdjukZqT0EMZUUXM4,648 -awscli/examples/codecommit/get-comments-for-compared-commit.rst,sha256=zAvuenQBIAWYSi5mGwVlck42Dot0bw0J0jZLDXDm7mQ,1786 -awscli/examples/codecommit/delete-comment-content.rst,sha256=dQEa1_h4BWYEHnPmCAXPpOR7C4XvuHCeK-XA7qGz5ZE,610 -awscli/examples/codecommit/post-comment-reply.rst,sha256=VPpUtafsNMGj9HXwxPHnCqpdBxspbm33btpua92Uacc,774 -awscli/examples/codecommit/create-repository.rst,sha256=8I8Wq25ylA0ut5Fc6L8p3mfXlV8NrB-3KkSWsYM0Nfw,799 -awscli/examples/codecommit/delete-repository.rst,sha256=TP3IeckGau_bj99sS4Vx1qeJUpdsJt-kFotuGJJWBec,244 -awscli/examples/codecommit/get-differences.rst,sha256=SoXGSdH_XQyBg_M7-peNkYkgHmG9T6EJSdieI2xp7Yk,1302 -awscli/examples/codecommit/get-commit.rst,sha256=IsMPr6t37XYBMfWz3-AraVtdVk1hxBvNCW2onDagWxI,917 -awscli/examples/codecommit/get-comments-for-pull-request.rst,sha256=oFgs32CRo2dHYqBE8oqbD-b-KSfdGl0E3TzzBGuSNuI,1707 -awscli/examples/codecommit/get-blob.rst,sha256=gYg4HSVFgzDH07IIKYi_KIhG9QycyiOr7YMT1zGnbig,360 -awscli/examples/codecommit/update-default-branch.rst,sha256=AKaCa6AMDedMWXHH-aOKhXDwMDaZU4O710nP6D4eTd4,312 -awscli/examples/codecommit/update-repository-name.rst,sha256=L1JrJuaZ5JYlREZlT2GEOgeXrXE0Zs63hPUjlRIGZDk,660 -awscli/examples/codecommit/list-pull-requests.rst,sha256=AkSFYmOqRbXEsl8bxsdrNrOcb5nSWspzHZBr8bJiFJc,515 -awscli/examples/codecommit/update-pull-request-title.rst,sha256=0GDC7GvWlKWLXkhrqALQhek6GGu2U_5D78Vskn6wwmU,1190 -awscli/examples/codecommit/update-repository-description.rst,sha256=Gc-jat1k_1QHySOMboIfvIi8vZaPalm1H76nHOFjvgQ,336 -awscli/examples/codecommit/post-comment-for-pull-request.rst,sha256=Oz-Lh8PmVnCC8mrSmjm66MKEkw6VoEnjDIwykvMsmW4,1529 -awscli/examples/codecommit/get-branch.rst,sha256=z87wYf0s4ywFvvh9VIe8JdKpMCZNNZyw8xXWIZOLZGg,330 -awscli/examples/codecommit/get-merge-conflicts.rst,sha256=koXSWjFvpCVkMY0azxSA8XoJJtLd1FYCSkGaZxLeDM8,607 -awscli/examples/codecommit/list-branches.rst,sha256=wzb1j0ogrhIv44CAblv76MMXTgnnRrqK418SZ33n5A4,260 -awscli/examples/codecommit/create-pull-request.rst,sha256=T9FuEW-eZvfjE0vjPSl1z0o9dpsyYD-Tg0GFCU22X0A,1341 -awscli/examples/codecommit/get-repository.rst,sha256=A1Bonw8DxxrE6SW9BhpgabqjqaG7N70JgwnxAM5Vx3s,862 -awscli/examples/codecommit/post-comment-for-compared-commit.rst,sha256=dv9Lhbod2EVLNghw6ijrxpHanrktXEcO-gOccSNHmfs,1395 -awscli/examples/codecommit/batch-get-repositories.rst,sha256=yJCpYl1aRncj3CRPJgYoVvL2O30b5H36jRq_JgKlhmY,1756 -awscli/examples/codecommit/get-pull-request.rst,sha256=Nf561O-GEHa9_uKdkt1noZfBibOceJmgzT9yuv40lrg,1012 -awscli/examples/codecommit/test-repository-triggers.rst,sha256=JaAu5SkmwOeKVHXKVeCRpe4pAMKfV7zD6XjY7He_ZbM,613 -awscli/examples/codecommit/update-comment.rst,sha256=F_AlmVZuN4tr12y0RG5I1pn1sWUJOfAQymbSQ3KeZJ0,691 -awscli/examples/sqs/list-queues.rst,sha256=lCE9rQHVS_nrKb5QPMc1ePPnKuhw-WAqfEs91IFcguA,789 -awscli/examples/sqs/change-message-visibility-batch.rst,sha256=33WIbGb9Je3Sb43Y33bev47JM1iwwX6EBkBIY8NeQYA,793 -awscli/examples/sqs/send-message.rst,sha256=qRAKGIxpxm16gJ6LFT-9Z8WS5CZdf8grtHUAS_b65-w,859 -awscli/examples/sqs/change-message-visibility.rst,sha256=fqWiiw84w0Z92b9diSdg1Vz9KgkyHd_xQMXKe4VVYks,359 -awscli/examples/sqs/remove-permission.rst,sha256=uN8mt-Ahyn5e0YooQqbs2aMvrvmyrQVIQAchmDmoBBY,274 -awscli/examples/sqs/delete-message.rst,sha256=0HzqgrtRMqXSFboL1xL4VUGYIWygj4Nr4lSgOL60s3k,230 -awscli/examples/sqs/get-queue-url.rst,sha256=ku6VHgDyEy8aZJpC8ZjBIBkPh0BghqKYZC-xqL7QuR0,211 -awscli/examples/sqs/send-message-batch.rst,sha256=WflsRRO41geubfHgd566DGLzZpyzMuXuWxmdECHoaoU,2185 -awscli/examples/sqs/receive-message.rst,sha256=I5c0OYXJfvsNIF8XocrGP4NmtdRZJqaBrSNFHYeJ-IQ,2011 -awscli/examples/sqs/list-dead-letter-source-queues.rst,sha256=pBo1vD_bpCrwp3rxGSHh1hfJ4GplfbPh3uLzSa1QuFI,429 -awscli/examples/sqs/delete-queue.rst,sha256=ZDO21GoXJfA1_Xr-nKKLz6VCckLccarHqph8LVnPAHc,192 -awscli/examples/sqs/get-queue-attributes.rst,sha256=9RNmNzBJNPXcOxg_KQKUTltg1VfoucoxhqyKcYpozVw,1270 -awscli/examples/sqs/add-permission.rst,sha256=lSAe9DNsW_dPH-OLVz0TGsUKo_DkEKLYUxs8iEEBjZU,333 -awscli/examples/sqs/delete-message-batch.rst,sha256=dkMySBioJSOeqhFlcPg5EA62KDHRFhQnh3I31ZvEC4g,594 -awscli/examples/sqs/purge-queue.rst,sha256=0n2DRzFURTx-oDi1jcCDNrak7jXbmYy2TiKHubxeo8U,204 -awscli/examples/sqs/set-queue-attributes.rst,sha256=sexJwigM0oY7prulLkmFAaYrJUTMHGoz9u5zkE5CNkk,989 -awscli/examples/sqs/create-queue.rst,sha256=IuwjIWvQDdzU2CMJhJDqn5xNYb4j9PrqIv2Ewd_mvBI,679 -awscli/examples/discovery/describe-agents.rst,sha256=0pfaXNT2BxsaQGjV1WSkhj5pYoV1keqoUqnOPuG7Oe4,1521 -awscli/examples/discovery/list-configurations.rst,sha256=x1ge-dcFwX4S3XYsqlRxq8zwLfNOurIv8LvRANL_lu4,1322 -awscli/examples/discovery/describe-configurations.rst,sha256=YK9xTcbri1FtaNq3Sb751EneNKqkYs6cM-9Mp9FDMoQ,6785 -awscli/examples/waf/update-ip-set.rst,sha256=erB1RZtT5jOxTrqgtbA5XEICCP8GaBaH_te47d27eeo,1152 -awscli/examples/waf/update-byte-match-set.rst,sha256=kCy03fiTa4hZY7Vd2nPslpm_s-h4zNznNq4mCFMNWsM,685 -awscli/examples/waf/update-sql-injection-match-set.rst,sha256=Tukx5UjjShXbGuVs7ilCx0qc7JyXuKF3rpx4tkIFaWo,700 -awscli/examples/waf/update-web-acl.rst,sha256=eOwLApWJIsZQL8FV3sEUDNhkd3xdmn7xQjYsyNMe06o,552 -awscli/examples/waf/update-xss-match-set.rst,sha256=q7VuivlNCMFkrI4CU8fy4Myijkl2GtZmqjjBqe2sWIg,645 -awscli/examples/waf/update-rule.rst,sha256=ehxJBDjzN4C62HthXRcey1JIL43_o6GGKwAJAKJacTg,503 -awscli/examples/waf/update-size-constraint-set.rst,sha256=UAJ8j2RDZb6j6eHIoFQOCgkGU5KjVKK0kg9CmHGe-8o,682 -awscli/examples/logs/describe-log-streams.rst,sha256=F_1I17ZRRQD7OlZ26GUX8J4JuCKnXFoN8rfNMus1vmA,731 -awscli/examples/logs/put-log-events.rst,sha256=FZgdBKgKpCD9JY3utTU7dJDFSyfztX3QQ4fI_VSMcEE,1095 -awscli/examples/logs/delete-retention-policy.rst,sha256=Om1FfMbdadmqXje63pxCXHXNRYXkI-1DPTEF-NTcuS4,180 -awscli/examples/logs/delete-log-stream.rst,sha256=gkjdvOIfVOiQb9-CZ0Ys9iuUrlz1aZvudAS4qcqDfcs,181 -awscli/examples/logs/create-log-stream.rst,sha256=RY2PfvP2_IW1HFlZ8VthJkxppIIi5NkH_T3drRI5xic,175 -awscli/examples/logs/describe-log-groups.rst,sha256=5cp-IIxrtsw76m0bOmXYZPvhuGKeagzeyrnq5ec_LV4,472 -awscli/examples/logs/delete-log-group.rst,sha256=kptGiGmE4vUHSbUIIavyiEpWMFTRzvLGgX-fMowt3qw,116 -awscli/examples/logs/create-log-group.rst,sha256=38Uk7E3o24TSJ-2f1ArpgcDPyP-jEXMBB0e8nGZuNTU,116 -awscli/examples/logs/get-log-events.rst,sha256=Ajrvd1U8N7cmxz24ZyV_YrItAbXq1GplB8m7kAZIYqA,879 -awscli/examples/logs/put-retention-policy.rst,sha256=bhj87TciRV11vh3AwZfeTwBfVdD_5o8RK2t_fqZJJrk,167 -awscli/customizations/sessionmanager.py,sha256=4nBP0koZpFZPQROSUnz-68rSLl23na8g21aJk2zwErw,3781 -awscli/customizations/route53.py,sha256=TyEnjZz7bPegLQ23X5r1tNUJ1gSAmGeQBaF98t5PLmU,1187 -awscli/customizations/iot_data.py,sha256=pSVa6y6mq-mxWwUFzRiJIxcHieWSSUqAQZr0xq40dbE,1231 -awscli/customizations/iot.py,sha256=GvkgUZKcDYjqfWOz160wUS7LVE_YhQ8NDZGzBHqsWc8,2399 -awscli/customizations/preview.py,sha256=5r4RHFS19pxZ79cimbPgL1YOstOjK9OvgUeaZAP0YA8,5189 -awscli/customizations/cloudsearch.py,sha256=nYxETlOloAInBau_WGlv6tKlTb9jrTKMteFKHlcFK7I,4291 -awscli/customizations/kms.py,sha256=MG52QeazTZ3xokURUqLK4asagZCThssaXv0Dg1JIOhc,909 -awscli/customizations/flatten.py,sha256=Yl9hPS2k87YqyAVXhaLFSA0KhluhZYTKKLXsM-nsfco,9505 -awscli/customizations/cloudfront.py,sha256=CutSXeW6-KRWcaf415Z0uAx-d4-gnOSRjlVbCTzhxl8,10580 -awscli/customizations/scalarparse.py,sha256=LIcIwHLHzFR1vQboh58N3spPEcR9IF2Wk9f-wA-IXoA,3041 -awscli/customizations/s3errormsg.py,sha256=STKQ3714dnXOzPSPszCikhv5hoRBUJnk-u0kFp7FaEU,2480 -awscli/customizations/cliinputjson.py,sha256=XWru9NHF0jNuhrA79xQY03vJPyRpe2Jth9tyXnsGqL8,3883 -awscli/customizations/s3endpoint.py,sha256=jf_Sz8FWzMqkKIMGsHZtRUoEaSgVa-2Zurv0X6cRmTc,1839 -awscli/customizations/awslambda.py,sha256=jBkq7-XWamdAeVbwWTMkjNe-Llf0GisMVqtNyhaCBIg,5923 -awscli/customizations/removals.py,sha256=yfKW4RqSnb-fLypytPg6c_Lye1cFL9l0HXgSS6Goaaw,2755 -awscli/customizations/assumerole.py,sha256=ybxUWO8ZDsjRFtF80UBFawzmDYLboMKFdq2-I9ti-jM,1669 -awscli/customizations/arguments.py,sha256=EgRCVs9HIbTcbYOn8hhMvKP-wr7tti7aNHr197E1GsE,5126 -awscli/customizations/toplevelbool.py,sha256=0LwcEYoGSQ1V77NVVJEXbwsc8WYt2RJonNiCelRefAQ,5906 -awscli/customizations/addexamples.py,sha256=3m-ADiuNN6HBHXdE42Vukm2tFYLrjAKrZNBVM_SZYoY,1813 -awscli/customizations/mturk.py,sha256=4n0c14Ah9ey11uiuW5n4gMlcMq7PQNuapeGSoOEh2lE,1010 -awscli/customizations/sessendemail.py,sha256=uWgx-f0ILiTGKyjoQcJWx8XoG-BIWUkWNBy-yXvYpTU,4459 -awscli/customizations/waiters.py,sha256=0WQMsPfXhBXyW6_4kDVTD-FbOoTst04gycLLi5m7biI,9737 -awscli/customizations/cloudsearchdomain.py,sha256=_uQctHHxAqSt_d4snYIWS3bEDeordU0jpZLb5xtYjzM,1074 -awscli/customizations/opsworks.py,sha256=OgpQeipF3Z2QRvbeDUcmJgU3jFejqBy7etiwA2SBbls,20138 -awscli/customizations/utils.py,sha256=Pr5pdBx_uttFboDDmA_GcptQ16oP1q5qYx_KO5cOtGw,8462 -awscli/customizations/putmetricdata.py,sha256=q6ZZHa0DPWId9VVK0C4z7kAfkSmJCQ4rJ-_CYhAnDXg,6913 -awscli/customizations/commands.py,sha256=1u3hUVnEu0BSkS-PcHJCSq9Gc-es-DUoqglqqcBA9Aw,17103 -awscli/customizations/streamingoutputarg.py,sha256=ZVog2DzONlgqoGOAtsAJLNUfjOi-QTYHmDFdFLxrrS0,3897 -awscli/customizations/generatecliskeleton.py,sha256=G5j4NRqZxkjgZzWCDyd3W64nQZTBxz7Rd0sZIKMC_M4,5803 -awscli/customizations/sagemaker.py,sha256=mlYPscN-aQgV6L8dRK62QolmY7_iDmtHLe6DyGjayD8,1014 -awscli/customizations/ecr.py,sha256=A3Ef9IIlll5F_lxWt_qKb-7cvJr0FA4mnNmAJX60NCI,3264 -awscli/customizations/s3uploader.py,sha256=nzYcL9R7OxYau3aEFdf2BIIvdN_oRpdpVkZrRKzqHDg,7904 -awscli/customizations/paginate.py,sha256=znJnCzXY7shgtSNPab9VFCO9flekDKxw-se-PqOvFQA,11957 -awscli/customizations/translate.py,sha256=kaUqLyrQGmnPOItK2zYfZDEex0s9YaMpPBRINyJwF8A,2603 -awscli/customizations/s3events.py,sha256=TvMUspwSEFEaUQ5k03uOyt63bpo7jpkQl0gq3wS-YcE,3511 -awscli/customizations/opsworkscm.py,sha256=-NVHq6-tC30nMeQ94cByL-tyd3syg-CDWociI0m7MA8,857 -awscli/customizations/rds.py,sha256=9aC5r9z4iKhvKp38B1EElU4sy4a2T50Orb4C30QwJtc,4217 -awscli/customizations/__init__.py,sha256=enP4McjXiSlxQrYPyUcOvpUtzy5Q2p6o9M6ydJPkbD0,1484 -awscli/customizations/argrename.py,sha256=hZ4Cq47Eo7eZuC08FJNp6XnolqEc8jeeCtOhvjAAFlI,6758 -awscli/customizations/iamvirtmfa.py,sha256=xoQ2the-0D6t6meJkM1FY7A9KTKape2RCV2a3VAljV4,3278 -awscli/customizations/rekognition.py,sha256=Hjuw7Ukf0_Fffh84AJrCXXrbQw1ROubYxN8sCo3MJ1g,3557 -awscli/customizations/codecommit.py,sha256=syjWZRNC8WXImlLmbBGrYccvlVD4nXUJEcFYqPVIY_M,7405 -awscli/customizations/globalargs.py,sha256=MmWBArwFnBRhr7_VdjwHciBAUIqQ0RO0vtM0G3dsGok,4486 -awscli/customizations/ec2/bundleinstance.py,sha256=3tZ5eZsPofSX-r1PwZmSOEwIf-Ji3DZRpiyzzZPVqoM,6746 -awscli/customizations/ec2/secgroupsimplify.py,sha256=um9bYjNn2saDzH5Uc3kjdTEgsqM3kwCL5oR60HhFKCg,8463 -awscli/customizations/ec2/decryptpassword.py,sha256=s9F0lO5TVQFrafpfriLw0J-syE9fpGuvzJtCPfri-AI,4597 -awscli/customizations/ec2/protocolarg.py,sha256=xcpJneFdg1JXXl3Ejp7B0Nl2mpJE4pDnlwZENhLobYw,1400 -awscli/customizations/ec2/runinstances.py,sha256=9icb5zhfDeuHsF7ybVHkqLZgS_Ld_-OFTT1XJwyu0ug,7759 -awscli/customizations/ec2/addcount.py,sha256=4WjyrcTVKdYXgFgslrAZX3V1svAaHpH7zJxlFSvDzYw,2992 -awscli/customizations/ec2/paginate.py,sha256=IX4kdGkT1j5hElfxWPxFBwl9XL-HZmqGy2mkYBOrnxk,2304 -awscli/customizations/ec2/__init__.py,sha256=wnWE_0bn2m84p3EPxwqRBDw2M63Q8PmX4IKHTUxl1e4,565 -awscli/customizations/datapipeline/listrunsformatter.py,sha256=4Gytk-ewHd22TZdc1Qoe19xyYJ1sJK97oo6m_q_9QVg,2131 -awscli/customizations/datapipeline/constants.py,sha256=8drCqQal41RKcW-MqLjFo_t1ta2WU18G76JP23yBefY,1895 -awscli/customizations/datapipeline/createdefaultroles.py,sha256=aTL9qJ1CH9y8OHZSxnQ854euYPb7LyYPa5sxFoSff_8,9544 -awscli/customizations/datapipeline/__init__.py,sha256=hu3AYTp3S3bZ6ygclJaxFNXTwVeu131aR7nXukmQt5g,16948 -awscli/customizations/datapipeline/translator.py,sha256=5RFeT4yKaU5jvSsnodMPgfLgMbn_4Dt4Flk1oc0FiVI,7212 -awscli/customizations/configservice/rename_cmd.py,sha256=RSAwnltldj7HC8Ex4OLcyUeff5JMvLE150m8RO66IXI,924 -awscli/customizations/configservice/subscribe.py,sha256=ZarlgoKHNMcMDjX6lcSNQiKZCPtrxydEgIPDl_o74ww,6996 -awscli/customizations/configservice/putconfigurationrecorder.py,sha256=Y7LrVfv1_R_0CwrDXIidP25I7Jf0qhcdQ7_IkEayRa4,3154 -awscli/customizations/configservice/getstatus.py,sha256=1wBv6nbhANKyDkXA56TdS-XushnsQNVK2fiz_pKcX7c,4258 -awscli/customizations/configservice/__init__.py,sha256=_5TbmyGbXMuErfCQRk40A91pi_Z7qVDO-_4GVyOz41U,565 -awscli/customizations/cloudformation/deployer.py,sha256=YhyO5PIXvoDf2M50_zB5aaCYbdIMsBiXqca80riDB7g,9683 -awscli/customizations/cloudformation/yamlhelper.py,sha256=vj2Wmkosmg2xfRG0xIzl0rAxLXYr4ZwG7A3-zASOl2A,2480 -awscli/customizations/cloudformation/deploy.py,sha256=qNTstt4bhPQ-EvdfTlyshVqvTAyxkjG3bym1bEfRYsw,14386 -awscli/customizations/cloudformation/package.py,sha256=g8WRb0BOOuZNlv5FoDi3bcA6Y4ZxZd6MAzhuFW9THgI,6123 -awscli/customizations/cloudformation/exceptions.py,sha256=a0YnnJHDYaak9a0kA2jBcPYXonwdFzjOfHgqjLmyqa4,1953 -awscli/customizations/cloudformation/artifact_exporter.py,sha256=bp6L-AByulBkPgVEXXx-mjNLobMxsFfhWscGb56j-wQ,18629 -awscli/customizations/cloudformation/__init__.py,sha256=rcZDPPnatHSw8I0ogt3eHOL4HKIW3DbUFKEZdf76TEg,1281 -awscli/customizations/configure/configure.py,sha256=xpNL4ZEhP25GTLvN8bgZxHgdSpLoafxBKUmLmY5u364,5959 -awscli/customizations/configure/get.py,sha256=S3JpzXQ8BKoeVbM7-JoYyPieyLGcwSPDsa7feqktuHQ,4255 -awscli/customizations/configure/set.py,sha256=wVVxGsk9DmgoJVXJPlXVWIBaFdr-uC2gMUrhzGTLGN8,4645 -awscli/customizations/configure/addmodel.py,sha256=4TBElqa-1FGi7hhfYMjBP2atd0ZLRBO6bTWGSbcp9ik,4864 -awscli/customizations/configure/writer.py,sha256=oUgeYML5DnIGIozQ8-bxpgGBxt0F6L9CsOFIs0c8aEo,8858 -awscli/customizations/configure/__init__.py,sha256=7bDoiDWWj7bEfE9VHtk29lCCnotO8OrZ9bXrE2DWNRA,1504 -awscli/customizations/configure/list.py,sha256=zc4EirIlBX4utadRMNSLxuJEBwGSnTz0_5lyxdr2p70,5507 -awscli/customizations/codedeploy/register.py,sha256=xvEm7u_kF3-7zP8pExQI9zQASPpU4h_ZhisKg0FxGJw,7196 -awscli/customizations/codedeploy/uninstall.py,sha256=TwtuDoqBdxK95GGp3UxQa2KqMj7T9aikhAKPxhSqYJs,2202 -awscli/customizations/codedeploy/locationargs.py,sha256=JupUxddF8XDUe0mSs3JiYKp7esCo6RuWGjo5o6N8-vc,5910 -awscli/customizations/codedeploy/systems.py,sha256=DivO1j6wvZiWXSgiJ-trfEvJWH9uPLIAd0nGpo4NlKA,7661 -awscli/customizations/codedeploy/deregister.py,sha256=BBDv1lT5Hp_CUMAy99gGxRWtuzfPxbNen7xd0iq9IX0,6205 -awscli/customizations/codedeploy/codedeploy.py,sha256=lQzSYdJK7Asz1EEspzRTmMVypnIRyOp27kIjHRobMQU,2212 -awscli/customizations/codedeploy/install.py,sha256=LZ9yeZuPolQdJ3CjR7R07Uwh9WOlOX5WgBbdxVAbT4k,4205 -awscli/customizations/codedeploy/push.py,sha256=_TNB8HbTwB91i1Ezr2865bb-ye0ygyvt6SzYElGWP0o,10675 -awscli/customizations/codedeploy/utils.py,sha256=ElrTUfRxOLe_D7x0X4WZykfBybo0lwlt6bXUODFoZkY,4597 -awscli/customizations/codedeploy/__init__.py,sha256=FT9vGCIrGANuGV5vZ8j_0DljBF6ocxqokqBGzPqFCio,565 -awscli/customizations/eks/update_kubeconfig.py,sha256=mOnW_TgcAcu8om8SRwnQv2wucJwvWtiYY85g4VbiciE,12380 -awscli/customizations/eks/ordered_yaml.py,sha256=81AoykbFpC6-k8m_3vyXRb3RM76mVtbzAI4PEPFKd4o,1864 -awscli/customizations/eks/exceptions.py,sha256=5Z3HntwF4htYVLK7oMgyCGSyd6Tou1DQ2Jg7irMkgqo,728 -awscli/customizations/eks/kubeconfig.py,sha256=qwis4ZYTQqIr98AFj4t63YbdRUFjcwvW9QS1oRWnrkQ,9190 -awscli/customizations/eks/__init__.py,sha256=uEXf7tBC5z7DA6ow4zyRBGmEjYQQEsNSUxSNA28knU4,1061 -awscli/customizations/ecs/filehelpers.py,sha256=5SEp-kljB91czCGxgudLkR6PWxv_73KiJqwUAj5KsUw,2126 -awscli/customizations/ecs/deploy.py,sha256=Ymt2HvSwBGVLRyrrSpXIdZnO1vLP92DWf6egYJJGUv4,15265 -awscli/customizations/ecs/exceptions.py,sha256=GnLehf5rBYnMBCeFPQAKnv73AgEBZ4vchb9vkSGT1HA,1500 -awscli/customizations/ecs/__init__.py,sha256=vN2JHs0dGnLLM-tpzbogWUvsZC2o3Nyyci_Mq_OHpwQ,1008 -awscli/customizations/s3/fileinfo.py,sha256=Zxw9urb41Zv3AUpOh1NC1UMxateHqhcEKIx7qdpsB_c,4184 -awscli/customizations/s3/s3handler.py,sha256=-fEyhfh8KxjJzakCG8OQQswYY-2V_yIyTjH2A8ROjiA,23299 -awscli/customizations/s3/filegenerator.py,sha256=IgepzINDhh-OJIssGn6WRkKaoFZlSgYuxV1aLpw3lxo,16072 -awscli/customizations/s3/fileformat.py,sha256=ZA2EYRS-dyYS0YtDAyKnbKneGHFqhID86Y98RnMC_fs,6029 -awscli/customizations/s3/comparator.py,sha256=TSDdTOHpngUZJ8pnzbGCDLp-g51vQKBZCsghJbFdyFw,6204 -awscli/customizations/s3/transferconfig.py,sha256=FAPf7-j-LXWWOQt8wLDSRG4jLgq2qXlWs9NKkTK6pts,4530 -awscli/customizations/s3/results.py,sha256=Dpn3l18s6dkY7EHzwsfxb5Er0w8cCp1YdebvP2bmOaI,26624 -awscli/customizations/s3/subcommands.py,sha256=uG5OugJ9Ox-vA0E7RuAF5BLZAKdaSwlL1z-0KHPeMXI,55253 -awscli/customizations/s3/fileinfobuilder.py,sha256=uv0q8FzKS9H83AGwqj2hgKNWx3LS4N0hNsLvQwgpYWA,3195 -awscli/customizations/s3/s3.py,sha256=40VhoH1R62T-Jsv2TpQ4kD2w46k8yjUbd6pXXcFz1FI,2741 -awscli/customizations/s3/utils.py,sha256=nVdx0adhAFs9WQlSFEY15ved2KYuImn_uC_O2538gNA,27377 -awscli/customizations/s3/filters.py,sha256=ZVW912Y1dL3Xez1q4VHOlZ0NN3be3imr4MCBNpP5s0I,6488 -awscli/customizations/s3/__init__.py,sha256=BFJ0dbdWkUBgJ2qav1Jhz06SddTMIeahxSaW_H0vop0,565 -awscli/customizations/s3/syncstrategy/register.py,sha256=2jsuidA4sxf3v1_9rpmp3tJRa2pGX35zYxzRluAmggs,2001 -awscli/customizations/s3/syncstrategy/sizeonly.py,sha256=UWNZK1Iv_byeNe_wps4ApKQJ7NnRTfgS5f5b27ewYMI,1300 -awscli/customizations/s3/syncstrategy/delete.py,sha256=AiLq0ig5YluVEdaVuMWoLSqJBe2XBVlkpcf87CoYbnc,1232 -awscli/customizations/s3/syncstrategy/__init__.py,sha256=BFJ0dbdWkUBgJ2qav1Jhz06SddTMIeahxSaW_H0vop0,565 -awscli/customizations/s3/syncstrategy/exacttimestamps.py,sha256=Bi_t4pbVfYbxKt4sKe3XJVYSbocfMTgg-HAx903Ts2o,1686 -awscli/customizations/s3/syncstrategy/base.py,sha256=fqAWhyw4mmz3wSx_zZh7CaCq63E1wpO-SOBT0IZTFKw,10112 -awscli/customizations/gamelift/uploadbuild.py,sha256=arEtPuaWw8qdv5NjbgWwqD7yavOkOZvHeByHwAWWhyo,6121 -awscli/customizations/gamelift/getlog.py,sha256=9YIegVUgRrddAmbV9B6pRfeImhZxgDQlI1cwkl8YMIM,2093 -awscli/customizations/gamelift/__init__.py,sha256=ReYcvAyUC5GLjv6Yx-PR3jO3ZsZiqGo9WdueWI-gtuc,1037 -awscli/customizations/cloudtrail/subscribe.py,sha256=LAVkOusmylEug51b5FqiGKJ5ZIXlXQyOQmz9qyPlV4w,13641 -awscli/customizations/cloudtrail/utils.py,sha256=dd-2CmiEbqXatOYOG5W7L-rpuxTatijdMJ-qmASrCwI,1224 -awscli/customizations/cloudtrail/validation.py,sha256=lIZLGgZXPjAiiMKnHcBg9tp4z8dsXeGM-QVbD55y8Bo,37894 -awscli/customizations/cloudtrail/__init__.py,sha256=6IMtaLoCrMMf1LdsmLLp5Q-uLeH_hpyCHIH1o2boYPQ,1337 -awscli/customizations/servicecatalog/helptext.py,sha256=jwtDliDWnv8UeijDKGMEmRvwWpLmEUi02hxvE_ijmek,1945 -awscli/customizations/servicecatalog/exceptions.py,sha256=y224fRHZBgTcx86PGxU0DBA9ntCxEjpiQH_TsqPyZf4,932 -awscli/customizations/servicecatalog/utils.py,sha256=8J4K6z2IVsxiD9Eathl7XvBcIJjo2U7ZVABhvSrKAz8,1173 -awscli/customizations/servicecatalog/generateproduct.py,sha256=k9iKmrZxi3_iD8JmU_FKt0SpqwRIsyxf1AwlymxuTbE,5609 -awscli/customizations/servicecatalog/generate.py,sha256=p_Efa8vtWvvKGQOGt6IZJTWMhfRBTy6sbk0-S3ztrV0,1460 -awscli/customizations/servicecatalog/generatebase.py,sha256=7S4SADhOV_IYOVyVhd8QHWVhpkIey9i8p-wi3uAaSQU,2305 -awscli/customizations/servicecatalog/__init__.py,sha256=y0BZXUIC-qc7rSrbfxH-drO5_kEwBzs6F3T10IQHhjA,928 -awscli/customizations/servicecatalog/generateprovisioningartifact.py,sha256=hgkvZ8ktGW9hoFQuR58MQKo-dWNOiKgDBIfShE8pFtw,3367 -awscli/customizations/emr/addtags.py,sha256=IDWlPXXWdoVEVek7V-0SlZmOhJWxm-5HPCPmmUGHcPI,1089 -awscli/customizations/emr/instancegroupsutils.py,sha256=-HBXYVdycBq59jHmnkXh1RA0YAoPL84bgtHJHy0k8gA,3444 -awscli/customizations/emr/constants.py,sha256=_qK4OLcIHvf7CCzFSOfsgyZXsdB_iPNkAN_H_iRMsHI,6625 -awscli/customizations/emr/command.py,sha256=pHxKJZR0FgGDopdmaxqpA1cZo1QogawHOxuu77vAV4U,5442 -awscli/customizations/emr/installapplications.py,sha256=J6ff1k-KGX7pxLzrBhBdsfi_XU0D1bO_MUK8PzoCWOM,2879 -awscli/customizations/emr/applicationutils.py,sha256=-SQQSlS4P8U4LjSKL9Bc6K7JD3pOMUaO2ADisgcEHko,6550 -awscli/customizations/emr/instancefleetsutils.py,sha256=ztdKnI8uyLY3RAeOvp-fyfdxMLPvUE6OfHgsMveAfEU,2479 -awscli/customizations/emr/listclusters.py,sha256=8PNPyA5181P9QCRZhGoTB3zFbzENCj30dryrCa2dH90,3775 -awscli/customizations/emr/addinstancegroups.py,sha256=4nMqT8Q8Z3stkPVkhUcfAyfx5dDs73_dNGwAO2KmUPI,2505 -awscli/customizations/emr/configutils.py,sha256=I7Hs_JFcrLUcXwVs4gHynaIZIk_oxBA7ADEYwkGAi60,2554 -awscli/customizations/emr/argumentschema.py,sha256=-W17BoHZNRuLhcLVG5_E8l49KNNTFlyNsp6MaGdFiI8,30405 -awscli/customizations/emr/emrfsutils.py,sha256=XyadeF_fVtW3IzgljHUGTGmrYPpAG2ytijzn7gC0JKI,9106 -awscli/customizations/emr/terminateclusters.py,sha256=O_-bz3kGpAa66FHhpI7IXTQ053iUrGVW1QBxC16MErU,1382 -awscli/customizations/emr/helptext.py,sha256=0b5XmvgzKVYQ0EoEFBQjRSHWy2FmEgCiT9OlXDB5G4Q,24802 -awscli/customizations/emr/hbaseutils.py,sha256=O-Dli_PHqv9_9JoKW-xKLcPN7h8y9-xdFsy51lS7gsg,953 -awscli/customizations/emr/exceptions.py,sha256=eQWaK2u2wc1-1TTvI3aeqZH0UTh0vDhv__XtGqMMB1c,10087 -awscli/customizations/emr/emrutils.py,sha256=16slwiIWWEQbAjNlhKrJv1XUuOGitkdH4C9kYMoj6EQ,8301 -awscli/customizations/emr/createcluster.py,sha256=Va0O-YGVuEbuSp3yxA9IoH_gPbxYYF4nLf5JPrdDnnY,24137 -awscli/customizations/emr/createdefaultroles.py,sha256=V2-vXRSkEHJ6TRghdWhJ6vJCXoxdJ8jgJQTk2FpKvnA,13281 -awscli/customizations/emr/modifyclusterattributes.py,sha256=CKcL1iqJPE0kEMGrUCoJMC74oxHwf-NjYDgUaTuE0F8,3639 -awscli/customizations/emr/describecluster.py,sha256=TX4evVKFrXuoAIdNebTncD5N8mtGwmUJ1jIFMt5CgvQ,4728 -awscli/customizations/emr/sshutils.py,sha256=3P3C_vWaMytJFeQwde2ViF2Ixz_r_n5PoNL3YDI11u4,3354 -awscli/customizations/emr/config.py,sha256=0MEd3p302iy3Iw6YTVARRwfflYHoXyV6BSlZbG0kCHg,4761 -awscli/customizations/emr/steputils.py,sha256=_GacW3TwlB5-TXJ_GlFhC6CR-5ndRCjxsWJutOB12dw,8482 -awscli/customizations/emr/hbase.py,sha256=ubr1r5CQiYGVDbv6CuV4ZKGOzuz7GDTG5WTD_u87K8M,9454 -awscli/customizations/emr/emr.py,sha256=6O8CzyB4NVFzeql4mARxQODgdbNOWlsXf874KPhO6EI,3257 -awscli/customizations/emr/__init__.py,sha256=_5TbmyGbXMuErfCQRk40A91pi_Z7qVDO-_4GVyOz41U,565 -awscli/customizations/emr/ssh.py,sha256=Guuh7aQcj3AA3-tNA1OGn4UQPr2Rj1uhiOMX1LCEU_o,7731 -awscli/customizations/emr/addsteps.py,sha256=tlz3GKFgcowvjueK3lXPnV2RksuxA-wSipw2_Ie5KQM,1947 -awscli/customizations/dlm/constants.py,sha256=tykCu9qtlN_Wd-592Y2RRaL6CCcE_F7i3UiEAjnrv3w,1199 -awscli/customizations/dlm/createdefaultrole.py,sha256=svz1KGwtgAyccSSj4AzgzmYpOcuIy0I8g5UfTSfHG28,5682 -awscli/customizations/dlm/dlm.py,sha256=NVAQOcoR8KSnCgCEX2D_mhSySMAIf32D6jeCJJCGbHo,1162 -awscli/customizations/dlm/iam.py,sha256=2EoD1tW_zN0BtGIM1sR--4bFq2TvbvDNu3dr3dWLBUg,1798 -awscli/customizations/dlm/__init__.py,sha256=fnY7NAZEHH-yfDk91prFN_0LTxutzUJQGf4L7Evm7Z0,565 -awscli/customizations/history/constants.py,sha256=tQvNo0q1VtMKrYsbNqJZ9GM6VWi1KnmQz_rUvOJwXdA,737 -awscli/customizations/history/db.py,sha256=v0LMV7Hnulh-eE5_4y9VB8zRtoOSjMKTbQ-wbNuYC1k,9246 -awscli/customizations/history/commands.py,sha256=sGjvLLCONdq92Kz8KI5jsodTUKIz8FoZ1SJkX0diT3k,2541 -awscli/customizations/history/filters.py,sha256=jKXspaeZ1NamcBQ11RaH7Pz6HMCdzkLCMKkxtaiwz-E,482 -awscli/customizations/history/__init__.py,sha256=XlHU1OXYU6TmUhmomxRYDajWd5y7Zwy-CFFcNxtiQ84,4120 -awscli/customizations/history/list.py,sha256=VEqrF1OdSRQTpWTxhOexH4X1H3K8AmeeCIQT8cW21MQ,4161 -awscli/customizations/history/show.py,sha256=F67pmJ69OXmedwpZQJZ9wbPBNewzBjYk1hkX6QFeDWU,15435 -awscli/data/cli.json,sha256=OdA8mqREAoK12VhlyX7Q8I-aYTrC0191nEJo-moqyj8,2975 -awscli/topics/topic-tags.json,sha256=6lUSrs3FKCZNRSQMnjcXNgWyRNGjZIeur1988a4IO5o,1577 -awscli/topics/s3-faq.rst,sha256=XoNcRfAg6eV2NdI-yWlmFaYuUNz987TK2UGlSISjjAo,2564 -awscli/topics/config-vars.rst,sha256=kl5Bvot1RSIH8-27fNiaXSK8TiE4Z6pTst_lzsFMn1s,16822 -awscli/topics/s3-config.rst,sha256=mJHaMkWgp38M4k6NZWYBhNGoNVpj88akqoeehgS4AuQ,11198 -awscli/topics/return-codes.rst,sha256=EYlgBSi4ZKjYE2UHOWOCvDRIt38OzPYFYDeCg5cHntw,1966 -awscli-1.16.71.dist-info/WHEEL,sha256=AvR0WeTpDaxT645bl5FQxUK6NPsTls2ttpcGJg3j1Xg,110 -awscli-1.16.71.dist-info/DESCRIPTION.rst,sha256=0NMiKNVjuDJA8EGtzTw2kcBSoZ2dumBhnYAzjkiPINA,17792 -awscli-1.16.71.dist-info/metadata.json,sha256=saDEhqn7EiydCgGl26H4tX1eGG4yaZecMV-Xv34G2ps,1298 -awscli-1.16.71.dist-info/METADATA,sha256=_9EZKaRXABhZpyAcQFGj6xlU6JHlzPrQquiD2m5SIig,19043 -awscli-1.16.71.dist-info/RECORD,, -awscli-1.16.71.dist-info/top_level.txt,sha256=vt9wXFr1_nGYK6abhJgt6zY3fULe4JSZedm_5XOM9S0,7 -../../bin/aws,sha256=r24FExgs0-JjILTQ3XZAqXBYE4SV6UMTtALkLGAj86g,805 -../../bin/aws.cmd,sha256=s46DkC6LNgX63CIkzxxbPnFMJ6DRDBkvc88GnWa8Pvg,1432 -../../bin/aws_zsh_completer.sh,sha256=wBScDPC1YoyF0WAGbix-8y1PXx_7csINXvASDbTk96U,1807 -../../bin/aws_bash_completer,sha256=RRpoEGJRagRzyHZKZZOwpltuVYv2EoiZsdXhmyWPZ54,204 -../../bin/aws_completer,sha256=oC9kuMDlWE47dWk_4xjPde2PQvN-M0vND0J4YSLabVQ,1126 -awscli-1.16.71.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 -awscli/customizations/s3/filters.pyc,, -awscli/customizations/s3/syncstrategy/sizeonly.pyc,, -awscli/customizations/emr/config.pyc,, -awscli/customizations/emr/terminateclusters.pyc,, -awscli/customizations/waiters.pyc,, -awscli/customizations/configservice/rename_cmd.pyc,, -awscli/customizations/s3/syncstrategy/base.pyc,, -awscli/customizations/rekognition.pyc,, -awscli/customizations/s3/subcommands.pyc,, -awscli/customizations/emr/createcluster.pyc,, -awscli/__main__.pyc,, -awscli/customizations/ec2/paginate.pyc,, -awscli/customizations/streamingoutputarg.pyc,, -awscli/argparser.pyc,, -awscli/table.pyc,, -awscli/customizations/ec2/secgroupsimplify.pyc,, -awscli/customizations/configservice/subscribe.pyc,, -awscli/text.pyc,, -awscli/customizations/commands.pyc,, -awscli/customizations/emr/instancegroupsutils.pyc,, -awscli/customizations/codedeploy/install.pyc,, -awscli/customizations/datapipeline/createdefaultroles.pyc,, -awscli/schema.pyc,, -awscli/customizations/putmetricdata.pyc,, -awscli/customizations/datapipeline/translator.pyc,, -awscli/customizations/configservice/__init__.pyc,, -awscli/customizations/emr/command.pyc,, -awscli/customizations/gamelift/uploadbuild.pyc,, -awscli/customizations/gamelift/__init__.pyc,, -awscli/compat.pyc,, -awscli/customizations/servicecatalog/generateprovisioningartifact.pyc,, -awscli/customizations/dlm/constants.pyc,, -awscli/customizations/s3uploader.pyc,, -awscli/customizations/s3/syncstrategy/delete.pyc,, -awscli/customizations/dlm/dlm.pyc,, -awscli/customizations/cloudformation/deploy.pyc,, -awscli/customizations/assumerole.pyc,, -awscli/customizations/codedeploy/deregister.pyc,, -awscli/customizations/codedeploy/push.pyc,, -awscli/customizations/globalargs.pyc,, -awscli/customizations/cliinputjson.pyc,, -awscli/customizations/emr/instancefleetsutils.pyc,, -awscli/customizations/s3/comparator.pyc,, -awscli/customizations/s3/fileinfo.pyc,, -awscli/customizations/emr/addinstancegroups.pyc,, -awscli/customizations/opsworkscm.pyc,, -awscli/plugin.pyc,, -awscli/__init__.pyc,, -awscli/customizations/codedeploy/register.pyc,, -awscli/customizations/emr/describecluster.pyc,, -awscli/topictags.pyc,, -awscli/customizations/generatecliskeleton.pyc,, -awscli/customizations/servicecatalog/utils.pyc,, -awscli/customizations/ecs/exceptions.pyc,, -awscli/customizations/eks/update_kubeconfig.pyc,, -awscli/formatter.pyc,, -awscli/customizations/configure/set.pyc,, -awscli/customizations/codecommit.pyc,, -awscli/customizations/s3/syncstrategy/__init__.pyc,, -awscli/customizations/emr/constants.pyc,, -awscli/customizations/awslambda.pyc,, -awscli/customizations/emr/configutils.pyc,, -awscli/customizations/s3/utils.pyc,, -awscli/customizations/emr/sshutils.pyc,, -awscli/customizations/s3/results.pyc,, -awscli/customizations/emr/exceptions.pyc,, -awscli/customizations/s3events.pyc,, -awscli/customizations/emr/addtags.pyc,, -awscli/customizations/eks/kubeconfig.pyc,, -awscli/customizations/ec2/addcount.pyc,, -awscli/customizations/cloudformation/deployer.pyc,, -awscli/customizations/cloudtrail/validation.pyc,, -awscli/customizations/translate.pyc,, -awscli/customizations/ec2/protocolarg.pyc,, -awscli/customizations/codedeploy/systems.pyc,, -awscli/customizations/emr/modifyclusterattributes.pyc,, -awscli/customizations/s3errormsg.pyc,, -awscli/customizations/s3endpoint.pyc,, -awscli/customizations/emr/listclusters.pyc,, -awscli/customizations/paginate.pyc,, -awscli/customizations/sessionmanager.pyc,, -awscli/customizations/ecs/__init__.pyc,, -awscli/customizations/opsworks.pyc,, -awscli/customizations/servicecatalog/generatebase.pyc,, -awscli/customizations/__init__.pyc,, -awscli/completer.pyc,, -awscli/customizations/datapipeline/listrunsformatter.pyc,, -awscli/customizations/emr/createdefaultroles.pyc,, -awscli/customizations/history/db.pyc,, -awscli/customizations/eks/ordered_yaml.pyc,, -awscli/customizations/servicecatalog/exceptions.pyc,, -awscli/customizations/s3/fileinfobuilder.pyc,, -awscli/customizations/dlm/iam.pyc,, -awscli/customizations/emr/emrutils.pyc,, -awscli/customizations/iot_data.pyc,, -awscli/customizations/emr/__init__.pyc,, -awscli/customizations/emr/addsteps.pyc,, -awscli/customizations/emr/ssh.pyc,, -awscli/customizations/configservice/getstatus.pyc,, -awscli/customizations/history/show.pyc,, -awscli/customizations/configure/get.pyc,, -awscli/customizations/s3/fileformat.pyc,, -awscli/customizations/cloudtrail/utils.pyc,, -awscli/customizations/sessendemail.pyc,, -awscli/customizations/removals.pyc,, -awscli/customizations/argrename.pyc,, -awscli/customizations/rds.pyc,, -awscli/customizations/datapipeline/__init__.pyc,, -awscli/customizations/history/filters.pyc,, -awscli/shorthand.pyc,, -awscli/customizations/ec2/runinstances.pyc,, -awscli/customizations/servicecatalog/helptext.pyc,, -awscli/customizations/configure/addmodel.pyc,, -awscli/customizations/scalarparse.pyc,, -awscli/customizations/history/__init__.pyc,, -awscli/customizations/sagemaker.pyc,, -awscli/handlers.pyc,, -awscli/customizations/cloudformation/exceptions.pyc,, -awscli/customizations/history/constants.pyc,, -awscli/customizations/history/commands.pyc,, -awscli/customizations/s3/s3handler.pyc,, -awscli/alias.pyc,, -awscli/customizations/ec2/__init__.pyc,, -awscli/customizations/cloudsearch.pyc,, -awscli/customizations/s3/s3.pyc,, -awscli/errorhandler.pyc,, -awscli/testutils.pyc,, -awscli/customizations/codedeploy/uninstall.pyc,, -awscli/customizations/cloudformation/__init__.pyc,, -awscli/clidocs.pyc,, -awscli/customizations/s3/syncstrategy/register.pyc,, -awscli/customizations/iot.pyc,, -awscli/customizations/configure/configure.pyc,, -awscli/customizations/ec2/decryptpassword.pyc,, -awscli/customizations/codedeploy/codedeploy.pyc,, -awscli/customizations/s3/syncstrategy/exacttimestamps.pyc,, -awscli/customizations/s3/__init__.pyc,, -awscli/customizations/codedeploy/locationargs.pyc,, -awscli/customizations/servicecatalog/__init__.pyc,, -awscli/customizations/emr/helptext.pyc,, -awscli/customizations/ecr.pyc,, -awscli/customizations/configure/__init__.pyc,, -awscli/customizations/cloudformation/package.pyc,, -awscli/customizations/addexamples.pyc,, -awscli/customizations/servicecatalog/generateproduct.pyc,, -awscli/commands.pyc,, -awscli/customizations/dlm/createdefaultrole.pyc,, -awscli/argprocess.pyc,, -awscli/customizations/emr/hbaseutils.pyc,, -awscli/customizations/s3/transferconfig.pyc,, -awscli/customizations/cloudfront.pyc,, -awscli/customizations/cloudtrail/__init__.pyc,, -awscli/customizations/cloudsearchdomain.pyc,, -awscli/customizations/gamelift/getlog.pyc,, -awscli/customizations/utils.pyc,, -awscli/arguments.pyc,, -awscli/customizations/eks/__init__.pyc,, -awscli/customizations/servicecatalog/generate.pyc,, -awscli/customizations/configure/writer.pyc,, -awscli/customizations/toplevelbool.pyc,, -awscli/customizations/emr/installapplications.pyc,, -awscli/customizations/flatten.pyc,, -awscli/customizations/s3/filegenerator.pyc,, -awscli/paramfile.pyc,, -awscli/customizations/route53.pyc,, -awscli/utils.pyc,, -awscli/customizations/configservice/putconfigurationrecorder.pyc,, -awscli/customizations/emr/hbase.pyc,, -awscli/customizations/emr/applicationutils.pyc,, -awscli/customizations/kms.pyc,, -awscli/customizations/emr/emrfsutils.pyc,, -awscli/clidriver.pyc,, -awscli/customizations/arguments.pyc,, -awscli/customizations/eks/exceptions.pyc,, -awscli/customizations/iamvirtmfa.pyc,, -awscli/customizations/cloudtrail/subscribe.pyc,, -awscli/customizations/history/list.pyc,, -awscli/customizations/ecs/deploy.pyc,, -awscli/customizations/preview.pyc,, -awscli/help.pyc,, -awscli/customizations/configure/list.pyc,, -awscli/customizations/codedeploy/__init__.pyc,, -awscli/customizations/ec2/bundleinstance.pyc,, -awscli/customizations/datapipeline/constants.pyc,, -awscli/customizations/emr/emr.pyc,, -awscli/customizations/dlm/__init__.pyc,, -awscli/customizations/emr/argumentschema.pyc,, -awscli/customizations/cloudformation/artifact_exporter.pyc,, -awscli/customizations/codedeploy/utils.pyc,, -awscli/customizations/mturk.pyc,, -awscli/customizations/emr/steputils.pyc,, -awscli/customizations/cloudformation/yamlhelper.pyc,, -awscli/customizations/ecs/filehelpers.pyc,, diff --git a/bin/awscli-1.16.71.dist-info/WHEEL b/bin/awscli-1.16.71.dist-info/WHEEL deleted file mode 100644 index 9dff69d8..00000000 --- a/bin/awscli-1.16.71.dist-info/WHEEL +++ /dev/null @@ -1,6 +0,0 @@ -Wheel-Version: 1.0 -Generator: bdist_wheel (0.24.0) -Root-Is-Purelib: true -Tag: py2-none-any -Tag: py3-none-any - diff --git a/bin/awscli-1.16.71.dist-info/metadata.json b/bin/awscli-1.16.71.dist-info/metadata.json deleted file mode 100644 index 570542c0..00000000 --- a/bin/awscli-1.16.71.dist-info/metadata.json +++ /dev/null @@ -1 +0,0 @@ -{"license": "Apache License 2.0", "name": "awscli", "metadata_version": "2.0", "generator": "bdist_wheel (0.24.0)", "summary": "Universal Command Line Environment for AWS.", "run_requires": [{"environment": "python_version==\"2.6\"", "requires": ["argparse>=1.1"]}, {"requires": ["botocore==1.12.61", "colorama>=0.2.5,<=0.3.9", "docutils>=0.10", "rsa>=3.1.2,<=3.5.0", "PyYAML>=3.10,<=3.13", "s3transfer>=0.1.12,<0.2.0"]}], "version": "1.16.71", "extensions": {"python.details": {"project_urls": {"Home": "http://aws.amazon.com/cli/"}, "document_names": {"description": "DESCRIPTION.rst"}, "contacts": [{"role": "author", "name": "Amazon Web Services"}]}}, "classifiers": ["Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "Natural Language :: English", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7"], "extras": []} \ No newline at end of file diff --git a/bin/awscli-1.16.71.dist-info/top_level.txt b/bin/awscli-1.16.71.dist-info/top_level.txt deleted file mode 100644 index 88294b13..00000000 --- a/bin/awscli-1.16.71.dist-info/top_level.txt +++ /dev/null @@ -1 +0,0 @@ -awscli diff --git a/bin/awscli/__init__.py b/bin/awscli/__init__.py index 58ec32d9..532ddb01 100644 --- a/bin/awscli/__init__.py +++ b/bin/awscli/__init__.py @@ -17,7 +17,7 @@ """ import os -__version__ = '1.16.71' +__version__ = '1.16.181' # # Get our data path to be added to botocore's search path diff --git a/bin/awscli/__init__.pyc b/bin/awscli/__init__.pyc deleted file mode 100644 index 077946de..00000000 Binary files a/bin/awscli/__init__.pyc and /dev/null differ diff --git a/bin/awscli/__main__.py b/bin/awscli/__main__.py index 330dcfdc..73a6388b 100644 --- a/bin/awscli/__main__.py +++ b/bin/awscli/__main__.py @@ -11,6 +11,18 @@ # ANY KIND, either express or implied. See the License for the specific # language governing permissions and limitations under the License. +# Don't remove this line. The idna encoding +# is used by getaddrinfo when dealing with unicode hostnames, +# and in some cases, there appears to be a race condition +# where threads will get a LookupError on getaddrinfo() saying +# that the encoding doesn't exist. Using the idna encoding before +# running any CLI code (and any threads it may create) ensures that +# the encodings.idna is imported and registered in the codecs registry, +# which will stop the LookupErrors from happening. +# See: https://bugs.python.org/issue29288 +u''.encode('idna') + + import sys from awscli.clidriver import main diff --git a/bin/awscli/__main__.pyc b/bin/awscli/__main__.pyc deleted file mode 100644 index 89f303f2..00000000 Binary files a/bin/awscli/__main__.pyc and /dev/null differ diff --git a/bin/awscli/alias.pyc b/bin/awscli/alias.pyc deleted file mode 100644 index d9c5f75d..00000000 Binary files a/bin/awscli/alias.pyc and /dev/null differ diff --git a/bin/awscli/argparser.pyc b/bin/awscli/argparser.pyc deleted file mode 100644 index 3aedba96..00000000 Binary files a/bin/awscli/argparser.pyc and /dev/null differ diff --git a/bin/awscli/argprocess.py b/bin/awscli/argprocess.py index 81816c69..75e99ad7 100644 --- a/bin/awscli/argprocess.py +++ b/bin/awscli/argprocess.py @@ -453,6 +453,10 @@ def _handle_special_cases(self, cli_argument, service_id, operation_name): self._uses_old_list_case( service_id, operation_name, cli_argument.name): member_name = list(model.member.members)[0] + # Handle special case where the min/max is exactly one. + metadata = model.metadata + if metadata.get('min') == 1 and metadata.get('max') == 1: + return '%s %s1' % (cli_argument.cli_name, member_name) return '%s %s1 %s2 %s3' % (cli_argument.cli_name, member_name, member_name, member_name) elif model.type_name == 'structure' and \ diff --git a/bin/awscli/argprocess.pyc b/bin/awscli/argprocess.pyc deleted file mode 100644 index ea928f8c..00000000 Binary files a/bin/awscli/argprocess.pyc and /dev/null differ diff --git a/bin/awscli/arguments.pyc b/bin/awscli/arguments.pyc deleted file mode 100644 index d5af4f5c..00000000 Binary files a/bin/awscli/arguments.pyc and /dev/null differ diff --git a/bin/awscli/clidocs.pyc b/bin/awscli/clidocs.pyc deleted file mode 100644 index e9c59f0a..00000000 Binary files a/bin/awscli/clidocs.pyc and /dev/null differ diff --git a/bin/awscli/clidriver.pyc b/bin/awscli/clidriver.pyc deleted file mode 100644 index 3aa49a13..00000000 Binary files a/bin/awscli/clidriver.pyc and /dev/null differ diff --git a/bin/awscli/commands.pyc b/bin/awscli/commands.pyc deleted file mode 100644 index f0af9045..00000000 Binary files a/bin/awscli/commands.pyc and /dev/null differ diff --git a/bin/awscli/compat.py b/bin/awscli/compat.py index 9817d960..66dc6c38 100644 --- a/bin/awscli/compat.py +++ b/bin/awscli/compat.py @@ -22,6 +22,8 @@ from botocore.compat import six #import botocore.compat +from botocore.compat import OrderedDict + # If you ever want to import from the vendored six. Add it here and then # import from awscli.compat. Also try to keep it in alphabetical order. # This may get large. @@ -97,6 +99,7 @@ def ensure_text_type(s): if six.PY3: + import collections.abc as collections_abc import locale import urllib.parse as urlparse @@ -146,6 +149,7 @@ def bytes_print(statement, stdout=None): else: import codecs + import collections as collections_abc import locale import io import urlparse @@ -339,71 +343,4 @@ def ignore_user_entered_signals(): yield finally: for sig, user_signal in enumerate(signal_list): - signal.signal(user_signal, actual_signals[sig]) - - -def _backport_which(cmd, mode=os.F_OK | os.X_OK, path=None): - """Given a command, mode, and a PATH string, return the path which - conforms to the given mode on the PATH, or None if there is no such - file. - `mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result - of os.environ.get("PATH"), or can be overridden with a custom search - path. - """ - # Check that a given file can be accessed with the correct mode. - # Additionally check that `file` is not a directory, as on Windows - # directories pass the os.access check. - def _access_check(fn, mode): - return (os.path.exists(fn) and os.access(fn, mode) - and not os.path.isdir(fn)) - - # If we're given a path with a directory part, look it up directly rather - # than referring to PATH directories. This includes checking relative to the - # current directory, e.g. ./script - if os.path.dirname(cmd): - if _access_check(cmd, mode): - return cmd - return None - - if path is None: - path = os.environ.get("PATH", os.defpath) - if not path: - return None - path = path.split(os.pathsep) - - if sys.platform == "win32": - # The current directory takes precedence on Windows. - if not os.curdir in path: - path.insert(0, os.curdir) - - # PATHEXT is necessary to check on Windows. - pathext = os.environ.get("PATHEXT", "").split(os.pathsep) - # See if the given file matches any of the expected path extensions. - # This will allow us to short circuit when given "python.exe". - # If it does match, only test that one, otherwise we have to try - # others. - if any(cmd.lower().endswith(ext.lower()) for ext in pathext): - files = [cmd] - else: - files = [cmd + ext for ext in pathext] - else: - # On other platforms you don't have things like PATHEXT to tell you - # what file suffixes are executable, so just pass on cmd as-is. - files = [cmd] - - seen = set() - for dir in path: - normdir = os.path.normcase(dir) - if not normdir in seen: - seen.add(normdir) - for thefile in files: - name = os.path.join(dir, thefile) - if _access_check(name, mode): - return name - return None - - -try: - from shutil import which -except ImportError: - which = _backport_which + signal.signal(user_signal, actual_signals[sig]) \ No newline at end of file diff --git a/bin/awscli/compat.pyc b/bin/awscli/compat.pyc deleted file mode 100644 index bc4e19ca..00000000 Binary files a/bin/awscli/compat.pyc and /dev/null differ diff --git a/bin/awscli/completer.pyc b/bin/awscli/completer.pyc deleted file mode 100644 index 27c0d843..00000000 Binary files a/bin/awscli/completer.pyc and /dev/null differ diff --git a/bin/awscli/customizations/__init__.pyc b/bin/awscli/customizations/__init__.pyc deleted file mode 100644 index eaa6647c..00000000 Binary files a/bin/awscli/customizations/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/addexamples.pyc b/bin/awscli/customizations/addexamples.pyc deleted file mode 100644 index 6f991752..00000000 Binary files a/bin/awscli/customizations/addexamples.pyc and /dev/null differ diff --git a/bin/awscli/customizations/argrename.py b/bin/awscli/customizations/argrename.py index f6634de4..4ed965ca 100644 --- a/bin/awscli/customizations/argrename.py +++ b/bin/awscli/customizations/argrename.py @@ -49,9 +49,13 @@ 'route53.update-traffic-policy-comment.version': 'traffic-policy-version', 'gamelift.create-build.version': 'build-version', 'gamelift.update-build.version': 'build-version', + 'gamelift.create-script.version': 'script-version', + 'gamelift.update-script.version': 'script-version', 'route53domains.view-billing.start': 'start-time', 'route53domains.view-billing.end': 'end-time', 'apigateway.create-rest-api.version': 'api-version', + 'apigatewayv2.create-api.version': 'api-version', + 'apigatewayv2.update-api.version': 'api-version', 'pinpoint.get-campaign-version.version': 'campaign-version', 'pinpoint.get-segment-version.version': 'segment-version', 'stepfunctions.send-task-success.output': 'task-output', @@ -72,6 +76,7 @@ 'mobile.create-project.region': 'project-region', 'rekognition.create-stream-processor.output': 'stream-processor-output', 'eks.create-cluster.version': 'kubernetes-version', + 'eks.update-cluster-version.version': 'kubernetes-version', } # Same format as ARGUMENT_RENAMES, but instead of renaming the arguments, diff --git a/bin/awscli/customizations/argrename.pyc b/bin/awscli/customizations/argrename.pyc deleted file mode 100644 index 1fee2d4d..00000000 Binary files a/bin/awscli/customizations/argrename.pyc and /dev/null differ diff --git a/bin/awscli/customizations/arguments.pyc b/bin/awscli/customizations/arguments.pyc deleted file mode 100644 index eaf31e45..00000000 Binary files a/bin/awscli/customizations/arguments.pyc and /dev/null differ diff --git a/bin/awscli/customizations/assumerole.pyc b/bin/awscli/customizations/assumerole.pyc deleted file mode 100644 index 0d6dcf3d..00000000 Binary files a/bin/awscli/customizations/assumerole.pyc and /dev/null differ diff --git a/bin/awscli/customizations/awslambda.pyc b/bin/awscli/customizations/awslambda.pyc deleted file mode 100644 index 2a4ee7dd..00000000 Binary files a/bin/awscli/customizations/awslambda.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cliinputjson.pyc b/bin/awscli/customizations/cliinputjson.pyc deleted file mode 100644 index f29a72ff..00000000 Binary files a/bin/awscli/customizations/cliinputjson.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudformation/__init__.pyc b/bin/awscli/customizations/cloudformation/__init__.pyc deleted file mode 100644 index 4129a4f9..00000000 Binary files a/bin/awscli/customizations/cloudformation/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudformation/artifact_exporter.py b/bin/awscli/customizations/cloudformation/artifact_exporter.py index 8f097613..936cad5f 100644 --- a/bin/awscli/customizations/cloudformation/artifact_exporter.py +++ b/bin/awscli/customizations/cloudformation/artifact_exporter.py @@ -19,12 +19,15 @@ import uuid import shutil from awscli.compat import six +from botocore.utils import set_value_from_jmespath from awscli.compat import urlparse from contextlib import contextmanager from awscli.customizations.cloudformation import exceptions from awscli.customizations.cloudformation.yamlhelper import yaml_dump, \ yaml_parse +import jmespath + LOG = logging.getLogger(__name__) @@ -120,7 +123,7 @@ def upload_local_artifacts(resource_id, resource_dict, property_name, :raise: ValueError if path is not a S3 URL or a local path """ - local_path = resource_dict.get(property_name, None) + local_path = jmespath.search(property_name, resource_dict) if local_path is None: # Build the root directory and upload to S3 @@ -183,7 +186,7 @@ def make_zip(filename, source_root): with open(zipfile_name, 'wb') as f: zip_file = zipfile.ZipFile(f, 'w', zipfile.ZIP_DEFLATED) with contextlib.closing(zip_file) as zf: - for root, dirs, files in os.walk(source_root): + for root, dirs, files in os.walk(source_root, followlinks=True): for filename in files: full_path = os.path.join(root, filename) relative_path = os.path.relpath( @@ -232,7 +235,7 @@ def export(self, resource_id, resource_dict, parent_dir): if resource_dict is None: return - property_value = resource_dict.get(self.PROPERTY_NAME, None) + property_value = jmespath.search(self.PROPERTY_NAME, resource_dict) if not property_value and not self.PACKAGE_NULL_PROPERTY: return @@ -248,7 +251,7 @@ def export(self, resource_id, resource_dict, parent_dir): if is_local_file(property_value) and not \ is_zip_file(property_value) and self.FORCE_ZIP: temp_dir = copy_to_temp_dir(property_value) - resource_dict[self.PROPERTY_NAME] = temp_dir + set_value_from_jmespath(resource_dict, self.PROPERTY_NAME, temp_dir) try: self.do_export(resource_id, resource_dict, parent_dir) @@ -269,10 +272,10 @@ def do_export(self, resource_id, resource_dict, parent_dir): Default export action is to upload artifacts and set the property to S3 URL of the uploaded object """ - resource_dict[self.PROPERTY_NAME] = \ - upload_local_artifacts(resource_id, resource_dict, + uploaded_url = upload_local_artifacts(resource_id, resource_dict, self.PROPERTY_NAME, parent_dir, self.uploader) + set_value_from_jmespath(resource_dict, self.PROPERTY_NAME, uploaded_url) class ResourceWithS3UrlDict(Resource): @@ -299,11 +302,12 @@ def do_export(self, resource_id, resource_dict, parent_dir): self.PROPERTY_NAME, parent_dir, self.uploader) - resource_dict[self.PROPERTY_NAME] = parse_s3_url( + parsed_url = parse_s3_url( artifact_s3_url, bucket_name_property=self.BUCKET_NAME_PROPERTY, object_key_property=self.OBJECT_KEY_PROPERTY, version_property=self.VERSION_PROPERTY) + set_value_from_jmespath(resource_dict, self.PROPERTY_NAME, parsed_url) class ServerlessFunctionResource(Resource): @@ -344,6 +348,22 @@ class AppSyncResolverResponseTemplateResource(Resource): PACKAGE_NULL_PROPERTY = False +class AppSyncFunctionConfigurationRequestTemplateResource(Resource): + RESOURCE_TYPE = "AWS::AppSync::FunctionConfiguration" + PROPERTY_NAME = "RequestMappingTemplateS3Location" + # Don't package the directory if RequestMappingTemplateS3Location is omitted. + # Necessary to support RequestMappingTemplate + PACKAGE_NULL_PROPERTY = False + + +class AppSyncFunctionConfigurationResponseTemplateResource(Resource): + RESOURCE_TYPE = "AWS::AppSync::FunctionConfiguration" + PROPERTY_NAME = "ResponseMappingTemplateS3Location" + # Don't package the directory if ResponseMappingTemplateS3Location is omitted. + # Necessary to support ResponseMappingTemplate + PACKAGE_NULL_PROPERTY = False + + class LambdaFunctionResource(ResourceWithS3UrlDict): RESOURCE_TYPE = "AWS::Lambda::Function" PROPERTY_NAME = "Code" @@ -385,6 +405,18 @@ class ServerlessLayerVersionResource(Resource): FORCE_ZIP = True +class ServerlessRepoApplicationReadme(Resource): + RESOURCE_TYPE = "AWS::ServerlessRepo::Application" + PROPERTY_NAME = "ReadmeUrl" + PACKAGE_NULL_PROPERTY = False + + +class ServerlessRepoApplicationLicense(Resource): + RESOURCE_TYPE = "AWS::ServerlessRepo::Application" + PROPERTY_NAME = "LicenseUrl" + PACKAGE_NULL_PROPERTY = False + + class CloudFormationStackResource(Resource): """ Represents CloudFormation::Stack resource that can refer to a nested @@ -431,8 +463,9 @@ def do_export(self, resource_id, resource_dict, parent_dir): # TemplateUrl property requires S3 URL to be in path-style format parts = parse_s3_url(url, version_property="Version") - resource_dict[self.PROPERTY_NAME] = self.uploader.to_path_style_s3_url( + s3_path_url = self.uploader.to_path_style_s3_url( parts["Key"], parts.get("Version", None)) + set_value_from_jmespath(resource_dict, self.PROPERTY_NAME, s3_path_url) class ServerlessApplicationResource(CloudFormationStackResource): @@ -444,12 +477,24 @@ class ServerlessApplicationResource(CloudFormationStackResource): PROPERTY_NAME = "Location" -EXPORT_LIST = [ + +class GlueJobCommandScriptLocationResource(Resource): + """ + Represents Glue::Job resource. + """ + RESOURCE_TYPE = "AWS::Glue::Job" + # Note the PROPERTY_NAME includes a '.' implying it's nested. + PROPERTY_NAME = "Command.ScriptLocation" + + +RESOURCES_EXPORT_LIST = [ ServerlessFunctionResource, ServerlessApiResource, GraphQLSchemaResource, AppSyncResolverRequestTemplateResource, AppSyncResolverResponseTemplateResource, + AppSyncFunctionConfigurationRequestTemplateResource, + AppSyncFunctionConfigurationResponseTemplateResource, ApiGatewayRestApiResource, LambdaFunctionResource, ElasticBeanstalkApplicationVersion, @@ -457,16 +502,39 @@ class ServerlessApplicationResource(CloudFormationStackResource): ServerlessApplicationResource, ServerlessLayerVersionResource, LambdaLayerVersionResource, + GlueJobCommandScriptLocationResource, +] + +METADATA_EXPORT_LIST = [ + ServerlessRepoApplicationReadme, + ServerlessRepoApplicationLicense ] -def include_transform_export_handler(template_dict, uploader): + +def include_transform_export_handler(template_dict, uploader, parent_dir): if template_dict.get("Name", None) != "AWS::Include": return template_dict - include_location = template_dict.get("Parameters", {}).get("Location", {}) - if (is_local_file(include_location)): - template_dict["Parameters"]["Location"] = uploader.upload_with_dedup(include_location) + + include_location = template_dict.get("Parameters", {}).get("Location", None) + if not include_location \ + or not is_path_value_valid(include_location) \ + or is_s3_url(include_location): + # `include_location` is either empty, or not a string, or an S3 URI + return template_dict + + # We are confident at this point that `include_location` is a string containing the local path + abs_include_location = os.path.join(parent_dir, include_location) + if is_local_file(abs_include_location): + template_dict["Parameters"]["Location"] = uploader.upload_with_dedup(abs_include_location) + else: + raise exceptions.InvalidLocalPathError( + resource_id="AWS::Include", + property_name="Location", + local_path=abs_include_location) + return template_dict + GLOBAL_EXPORT_DICT = { "Fn::Transform": include_transform_export_handler } @@ -478,7 +546,8 @@ class Template(object): """ def __init__(self, template_path, parent_dir, uploader, - resources_to_export=EXPORT_LIST): + resources_to_export=RESOURCES_EXPORT_LIST, + metadata_to_export=METADATA_EXPORT_LIST): """ Reads the template and makes it ready for export """ @@ -497,6 +566,7 @@ def __init__(self, template_path, parent_dir, uploader, self.template_dict = yaml_parse(template_str) self.template_dir = template_dir self.resources_to_export = resources_to_export + self.metadata_to_export = metadata_to_export self.uploader = uploader def export_global_artifacts(self, template_dict): @@ -508,7 +578,7 @@ def export_global_artifacts(self, template_dict): """ for key, val in template_dict.items(): if key in GLOBAL_EXPORT_DICT: - template_dict[key] = GLOBAL_EXPORT_DICT[key](val, self.uploader) + template_dict[key] = GLOBAL_EXPORT_DICT[key](val, self.uploader, self.template_dir) elif isinstance(val, dict): self.export_global_artifacts(val) elif isinstance(val, list): @@ -517,6 +587,26 @@ def export_global_artifacts(self, template_dict): self.export_global_artifacts(item) return template_dict + def export_metadata(self, template_dict): + """ + Exports the local artifacts referenced by the metadata section in + the given template to an s3 bucket. + + :return: The template with references to artifacts that have been + exported to s3. + """ + if "Metadata" not in template_dict: + return template_dict + + for metadata_type, metadata_dict in template_dict["Metadata"].items(): + for exporter_class in self.metadata_to_export: + if exporter_class.RESOURCE_TYPE != metadata_type: + continue + + exporter = exporter_class(self.uploader) + exporter.export(metadata_type, metadata_dict, self.template_dir) + + return template_dict def export(self): """ @@ -526,6 +616,8 @@ def export(self): :return: The template with references to artifacts that have been exported to s3. """ + self.template_dict = self.export_metadata(self.template_dict) + if "Resources" not in self.template_dict: return self.template_dict diff --git a/bin/awscli/customizations/cloudformation/artifact_exporter.pyc b/bin/awscli/customizations/cloudformation/artifact_exporter.pyc deleted file mode 100644 index 08904fae..00000000 Binary files a/bin/awscli/customizations/cloudformation/artifact_exporter.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudformation/deploy.py b/bin/awscli/customizations/cloudformation/deploy.py index 61a132b0..3b944045 100644 --- a/bin/awscli/customizations/cloudformation/deploy.py +++ b/bin/awscli/customizations/cloudformation/deploy.py @@ -280,7 +280,6 @@ def _run_main(self, parsed_args, parsed_globals): s3_uploader = S3Uploader(s3_client, bucket, - parsed_globals.region, parsed_args.s3_prefix, parsed_args.kms_key_id, parsed_args.force_upload) diff --git a/bin/awscli/customizations/cloudformation/deploy.pyc b/bin/awscli/customizations/cloudformation/deploy.pyc deleted file mode 100644 index 7760a9b7..00000000 Binary files a/bin/awscli/customizations/cloudformation/deploy.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudformation/deployer.pyc b/bin/awscli/customizations/cloudformation/deployer.pyc deleted file mode 100644 index 0e587932..00000000 Binary files a/bin/awscli/customizations/cloudformation/deployer.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudformation/exceptions.pyc b/bin/awscli/customizations/cloudformation/exceptions.pyc deleted file mode 100644 index de35a4c4..00000000 Binary files a/bin/awscli/customizations/cloudformation/exceptions.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudformation/package.py b/bin/awscli/customizations/cloudformation/package.py index bd45ac93..9bc7464d 100644 --- a/bin/awscli/customizations/cloudformation/package.py +++ b/bin/awscli/customizations/cloudformation/package.py @@ -139,7 +139,6 @@ def _run_main(self, parsed_args, parsed_globals): self.s3_uploader = S3Uploader(s3_client, bucket, - parsed_globals.region, parsed_args.s3_prefix, parsed_args.kms_key_id, parsed_args.force_upload) diff --git a/bin/awscli/customizations/cloudformation/package.pyc b/bin/awscli/customizations/cloudformation/package.pyc deleted file mode 100644 index 5f62fbe4..00000000 Binary files a/bin/awscli/customizations/cloudformation/package.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudformation/yamlhelper.py b/bin/awscli/customizations/cloudformation/yamlhelper.py index 41bbd7b6..bc845170 100644 --- a/bin/awscli/customizations/cloudformation/yamlhelper.py +++ b/bin/awscli/customizations/cloudformation/yamlhelper.py @@ -10,7 +10,9 @@ # 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 json +from botocore.compat import json +from botocore.compat import OrderedDict + import yaml from yaml.resolver import ScalarNode, SequenceNode @@ -54,13 +56,28 @@ def intrinsics_multi_constructor(loader, tag_prefix, node): return {cfntag: value} +def _dict_representer(dumper, data): + return dumper.represent_dict(data.items()) + + def yaml_dump(dict_to_dump): """ Dumps the dictionary as a YAML document :param dict_to_dump: :return: """ - return yaml.safe_dump(dict_to_dump, default_flow_style=False) + FlattenAliasDumper.add_representer(OrderedDict, _dict_representer) + return yaml.dump( + dict_to_dump, + default_flow_style=False, + Dumper=FlattenAliasDumper, + ) + + +def _dict_constructor(loader, node): + # Necessary in order to make yaml merge tags work + loader.flatten_mapping(node) + return OrderedDict(loader.construct_pairs(node)) def yaml_parse(yamlstr): @@ -69,8 +86,14 @@ def yaml_parse(yamlstr): # PyYAML doesn't support json as well as it should, so if the input # is actually just json it is better to parse it with the standard # json parser. - return json.loads(yamlstr) + return json.loads(yamlstr, object_pairs_hook=OrderedDict) except ValueError: + yaml.SafeLoader.add_constructor(yaml.resolver.BaseResolver.DEFAULT_MAPPING_TAG, _dict_constructor) yaml.SafeLoader.add_multi_constructor( "!", intrinsics_multi_constructor) return yaml.safe_load(yamlstr) + + +class FlattenAliasDumper(yaml.SafeDumper): + def ignore_aliases(self, data): + return True diff --git a/bin/awscli/customizations/cloudformation/yamlhelper.pyc b/bin/awscli/customizations/cloudformation/yamlhelper.pyc deleted file mode 100644 index 838f4382..00000000 Binary files a/bin/awscli/customizations/cloudformation/yamlhelper.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudfront.pyc b/bin/awscli/customizations/cloudfront.pyc deleted file mode 100644 index df060777..00000000 Binary files a/bin/awscli/customizations/cloudfront.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudsearch.pyc b/bin/awscli/customizations/cloudsearch.pyc deleted file mode 100644 index 16188aa0..00000000 Binary files a/bin/awscli/customizations/cloudsearch.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudsearchdomain.pyc b/bin/awscli/customizations/cloudsearchdomain.pyc deleted file mode 100644 index f1b86716..00000000 Binary files a/bin/awscli/customizations/cloudsearchdomain.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudtrail/__init__.pyc b/bin/awscli/customizations/cloudtrail/__init__.pyc deleted file mode 100644 index 3286fe42..00000000 Binary files a/bin/awscli/customizations/cloudtrail/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudtrail/subscribe.pyc b/bin/awscli/customizations/cloudtrail/subscribe.pyc deleted file mode 100644 index 1bb0b503..00000000 Binary files a/bin/awscli/customizations/cloudtrail/subscribe.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudtrail/utils.pyc b/bin/awscli/customizations/cloudtrail/utils.pyc deleted file mode 100644 index a79f8b28..00000000 Binary files a/bin/awscli/customizations/cloudtrail/utils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/cloudtrail/validation.pyc b/bin/awscli/customizations/cloudtrail/validation.pyc deleted file mode 100644 index 82c47158..00000000 Binary files a/bin/awscli/customizations/cloudtrail/validation.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codecommit.py b/bin/awscli/customizations/codecommit.py index 1bb3d9d6..d61e1551 100644 --- a/bin/awscli/customizations/codecommit.py +++ b/bin/awscli/customizations/codecommit.py @@ -133,10 +133,10 @@ def extract_url(self, parameters): return url def extract_region(self, parameters, parsed_globals): - match = re.match(r'git-codecommit\.([^.]+)\.amazonaws\.com', + match = re.match(r'(vpce-.+\.)?git-codecommit(-fips)?\.([^.]+)\.(vpce\.)?amazonaws\.com', parameters['host']) if match is not None: - return match.group(1) + return match.group(3) elif parsed_globals.region is not None: return parsed_globals.region else: diff --git a/bin/awscli/customizations/codecommit.pyc b/bin/awscli/customizations/codecommit.pyc deleted file mode 100644 index 191d8e58..00000000 Binary files a/bin/awscli/customizations/codecommit.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codedeploy/__init__.pyc b/bin/awscli/customizations/codedeploy/__init__.pyc deleted file mode 100644 index 72ba28a6..00000000 Binary files a/bin/awscli/customizations/codedeploy/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codedeploy/codedeploy.pyc b/bin/awscli/customizations/codedeploy/codedeploy.pyc deleted file mode 100644 index 056c76a7..00000000 Binary files a/bin/awscli/customizations/codedeploy/codedeploy.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codedeploy/deregister.pyc b/bin/awscli/customizations/codedeploy/deregister.pyc deleted file mode 100644 index 055d0abb..00000000 Binary files a/bin/awscli/customizations/codedeploy/deregister.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codedeploy/install.pyc b/bin/awscli/customizations/codedeploy/install.pyc deleted file mode 100644 index 6c899534..00000000 Binary files a/bin/awscli/customizations/codedeploy/install.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codedeploy/locationargs.pyc b/bin/awscli/customizations/codedeploy/locationargs.pyc deleted file mode 100644 index 29bf6bb6..00000000 Binary files a/bin/awscli/customizations/codedeploy/locationargs.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codedeploy/push.pyc b/bin/awscli/customizations/codedeploy/push.pyc deleted file mode 100644 index dc1bb8b7..00000000 Binary files a/bin/awscli/customizations/codedeploy/push.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codedeploy/register.pyc b/bin/awscli/customizations/codedeploy/register.pyc deleted file mode 100644 index 60a3936e..00000000 Binary files a/bin/awscli/customizations/codedeploy/register.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codedeploy/systems.pyc b/bin/awscli/customizations/codedeploy/systems.pyc deleted file mode 100644 index b7c52080..00000000 Binary files a/bin/awscli/customizations/codedeploy/systems.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codedeploy/uninstall.pyc b/bin/awscli/customizations/codedeploy/uninstall.pyc deleted file mode 100644 index 33c2455b..00000000 Binary files a/bin/awscli/customizations/codedeploy/uninstall.pyc and /dev/null differ diff --git a/bin/awscli/customizations/codedeploy/utils.pyc b/bin/awscli/customizations/codedeploy/utils.pyc deleted file mode 100644 index 84af2f51..00000000 Binary files a/bin/awscli/customizations/codedeploy/utils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/commands.pyc b/bin/awscli/customizations/commands.pyc deleted file mode 100644 index b0b3fb99..00000000 Binary files a/bin/awscli/customizations/commands.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configservice/__init__.pyc b/bin/awscli/customizations/configservice/__init__.pyc deleted file mode 100644 index f166163c..00000000 Binary files a/bin/awscli/customizations/configservice/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configservice/getstatus.pyc b/bin/awscli/customizations/configservice/getstatus.pyc deleted file mode 100644 index eb6fde12..00000000 Binary files a/bin/awscli/customizations/configservice/getstatus.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configservice/putconfigurationrecorder.pyc b/bin/awscli/customizations/configservice/putconfigurationrecorder.pyc deleted file mode 100644 index a23fc91e..00000000 Binary files a/bin/awscli/customizations/configservice/putconfigurationrecorder.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configservice/rename_cmd.pyc b/bin/awscli/customizations/configservice/rename_cmd.pyc deleted file mode 100644 index b06a4620..00000000 Binary files a/bin/awscli/customizations/configservice/rename_cmd.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configservice/subscribe.pyc b/bin/awscli/customizations/configservice/subscribe.pyc deleted file mode 100644 index 5171be36..00000000 Binary files a/bin/awscli/customizations/configservice/subscribe.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configure/__init__.pyc b/bin/awscli/customizations/configure/__init__.pyc deleted file mode 100644 index 626d19da..00000000 Binary files a/bin/awscli/customizations/configure/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configure/addmodel.pyc b/bin/awscli/customizations/configure/addmodel.pyc deleted file mode 100644 index 941c9c9e..00000000 Binary files a/bin/awscli/customizations/configure/addmodel.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configure/configure.pyc b/bin/awscli/customizations/configure/configure.pyc deleted file mode 100644 index 8b77a498..00000000 Binary files a/bin/awscli/customizations/configure/configure.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configure/get.pyc b/bin/awscli/customizations/configure/get.pyc deleted file mode 100644 index 9fc6ac8b..00000000 Binary files a/bin/awscli/customizations/configure/get.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configure/list.pyc b/bin/awscli/customizations/configure/list.pyc deleted file mode 100644 index 85bfe358..00000000 Binary files a/bin/awscli/customizations/configure/list.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configure/set.pyc b/bin/awscli/customizations/configure/set.pyc deleted file mode 100644 index 3ffa5b51..00000000 Binary files a/bin/awscli/customizations/configure/set.pyc and /dev/null differ diff --git a/bin/awscli/customizations/configure/writer.pyc b/bin/awscli/customizations/configure/writer.pyc deleted file mode 100644 index 05770d87..00000000 Binary files a/bin/awscli/customizations/configure/writer.pyc and /dev/null differ diff --git a/bin/awscli/customizations/datapipeline/__init__.pyc b/bin/awscli/customizations/datapipeline/__init__.pyc deleted file mode 100644 index 0943f173..00000000 Binary files a/bin/awscli/customizations/datapipeline/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/datapipeline/constants.pyc b/bin/awscli/customizations/datapipeline/constants.pyc deleted file mode 100644 index 794731d2..00000000 Binary files a/bin/awscli/customizations/datapipeline/constants.pyc and /dev/null differ diff --git a/bin/awscli/customizations/datapipeline/createdefaultroles.pyc b/bin/awscli/customizations/datapipeline/createdefaultroles.pyc deleted file mode 100644 index 143eee69..00000000 Binary files a/bin/awscli/customizations/datapipeline/createdefaultroles.pyc and /dev/null differ diff --git a/bin/awscli/customizations/datapipeline/listrunsformatter.pyc b/bin/awscli/customizations/datapipeline/listrunsformatter.pyc deleted file mode 100644 index f2b6f778..00000000 Binary files a/bin/awscli/customizations/datapipeline/listrunsformatter.pyc and /dev/null differ diff --git a/bin/awscli/customizations/datapipeline/translator.pyc b/bin/awscli/customizations/datapipeline/translator.pyc deleted file mode 100644 index 54c2e15a..00000000 Binary files a/bin/awscli/customizations/datapipeline/translator.pyc and /dev/null differ diff --git a/bin/awscli/customizations/dlm/__init__.pyc b/bin/awscli/customizations/dlm/__init__.pyc deleted file mode 100644 index 1e6d77ab..00000000 Binary files a/bin/awscli/customizations/dlm/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/dlm/constants.pyc b/bin/awscli/customizations/dlm/constants.pyc deleted file mode 100644 index 5fc6942e..00000000 Binary files a/bin/awscli/customizations/dlm/constants.pyc and /dev/null differ diff --git a/bin/awscli/customizations/dlm/createdefaultrole.pyc b/bin/awscli/customizations/dlm/createdefaultrole.pyc deleted file mode 100644 index 4a2836fe..00000000 Binary files a/bin/awscli/customizations/dlm/createdefaultrole.pyc and /dev/null differ diff --git a/bin/awscli/customizations/dlm/dlm.pyc b/bin/awscli/customizations/dlm/dlm.pyc deleted file mode 100644 index e4a8e8ac..00000000 Binary files a/bin/awscli/customizations/dlm/dlm.pyc and /dev/null differ diff --git a/bin/awscli/customizations/dlm/iam.pyc b/bin/awscli/customizations/dlm/iam.pyc deleted file mode 100644 index c061f1f5..00000000 Binary files a/bin/awscli/customizations/dlm/iam.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ec2/__init__.pyc b/bin/awscli/customizations/ec2/__init__.pyc deleted file mode 100644 index b44875c2..00000000 Binary files a/bin/awscli/customizations/ec2/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ec2/addcount.pyc b/bin/awscli/customizations/ec2/addcount.pyc deleted file mode 100644 index 6fe29b7f..00000000 Binary files a/bin/awscli/customizations/ec2/addcount.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ec2/bundleinstance.pyc b/bin/awscli/customizations/ec2/bundleinstance.pyc deleted file mode 100644 index 0bd3d1a0..00000000 Binary files a/bin/awscli/customizations/ec2/bundleinstance.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ec2/decryptpassword.pyc b/bin/awscli/customizations/ec2/decryptpassword.pyc deleted file mode 100644 index 5334f0d9..00000000 Binary files a/bin/awscli/customizations/ec2/decryptpassword.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ec2/paginate.pyc b/bin/awscli/customizations/ec2/paginate.pyc deleted file mode 100644 index 95b2bd0f..00000000 Binary files a/bin/awscli/customizations/ec2/paginate.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ec2/protocolarg.pyc b/bin/awscli/customizations/ec2/protocolarg.pyc deleted file mode 100644 index cc5f3471..00000000 Binary files a/bin/awscli/customizations/ec2/protocolarg.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ec2/runinstances.pyc b/bin/awscli/customizations/ec2/runinstances.pyc deleted file mode 100644 index 2d1e6115..00000000 Binary files a/bin/awscli/customizations/ec2/runinstances.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ec2/secgroupsimplify.pyc b/bin/awscli/customizations/ec2/secgroupsimplify.pyc deleted file mode 100644 index 41f512d8..00000000 Binary files a/bin/awscli/customizations/ec2/secgroupsimplify.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ecr.pyc b/bin/awscli/customizations/ecr.pyc deleted file mode 100644 index 84191662..00000000 Binary files a/bin/awscli/customizations/ecr.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ecs/__init__.pyc b/bin/awscli/customizations/ecs/__init__.pyc deleted file mode 100644 index d4dba566..00000000 Binary files a/bin/awscli/customizations/ecs/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ecs/deploy.py b/bin/awscli/customizations/ecs/deploy.py index aa25b627..f2029a18 100644 --- a/bin/awscli/customizations/ecs/deploy.py +++ b/bin/awscli/customizations/ecs/deploy.py @@ -22,6 +22,10 @@ from awscli.customizations.ecs import exceptions, filehelpers from awscli.customizations.commands import BasicCommand +TIMEOUT_BUFFER_MIN = 10 +DEFAULT_DELAY_SEC = 15 +MAX_WAIT_MIN = 360 # 6 hours + class ECSDeploy(BasicCommand): NAME = 'deploy' @@ -33,7 +37,9 @@ class ECSDeploy(BasicCommand): "CodeDeploy appspec with the new task definition revision, create a " "CodeDeploy deployment, and wait for the deployment to successfully " "complete. This command will exit with a return code of 255 if the " - "deployment does not succeed within 30 minutes." + "deployment does not succeed within 30 minutes by default or " + "up to 10 minutes more than your deployment group's configured wait " + "time (max of 6 hours)." ) ARG_TABLE = [ @@ -100,7 +106,8 @@ class ECSDeploy(BasicCommand): MSG_CREATED_DEPLOYMENT = "Successfully created deployment {id}\n" - MSG_WAITING = "Waiting for {deployment_id} to succeed..." + MSG_SUCCESS = ("Successfully deployed {task_def} to " + "service '{service}'\n") def _run_main(self, parsed_args, parsed_globals): @@ -121,6 +128,8 @@ def _run_main(self, parsed_args, parsed_globals): self._validate_code_deploy_resources(codedeploy_client) + self.wait_time = self._cd_validator.get_deployment_wait_time() + self.task_def_arn = self._register_task_def( register_task_def_kwargs, ecs_client_wrapper) @@ -135,12 +144,15 @@ def _create_and_wait_for_deployment(self, client, appspec): sys.stdout.write(self.MSG_CREATED_DEPLOYMENT.format( id=deployment_id)) + + deployer.wait_for_deploy_success(deployment_id, self.wait_time) + service_name = self.resources['service'] + sys.stdout.write( - self.MSG_WAITING.format(deployment_id=deployment_id)) + self.MSG_SUCCESS.format( + task_def=self.task_def_arn, service=service_name)) sys.stdout.flush() - deployer.wait_for_deploy_success(deployment_id) - def _get_file_contents(self, file_path): full_path = os.path.expandvars(os.path.expanduser(file_path)) try: @@ -193,9 +205,14 @@ def _validate_code_deploy_resources(self, client): validator = CodeDeployValidator(client, self.resources) validator.describe_cd_resources() validator.validate_all() + self._cd_validator = validator class CodeDeployer(): + + MSG_WAITING = ("Waiting for {deployment_id} to succeed " + "(will wait up to {wait} minutes)...\n") + def __init__(self, cd_client, appspec_dict): self._client = cd_client self._appspec_dict = appspec_dict @@ -273,9 +290,30 @@ def update_task_def_arn(self, new_arn): appspec_obj[resources_key] = updated_resources self._appspec_dict = appspec_obj - def wait_for_deploy_success(self, id): + def wait_for_deploy_success(self, id, wait_min): waiter = self._client.get_waiter("deployment_successful") - waiter.wait(deploymentId=id) + + if wait_min is not None and wait_min > MAX_WAIT_MIN: + wait_min = MAX_WAIT_MIN + + elif wait_min is None or wait_min < 30: + wait_min = 30 + + delay_sec = DEFAULT_DELAY_SEC + max_attempts = (wait_min * 60) / delay_sec + config = { + 'Delay': delay_sec, + 'MaxAttempts': max_attempts + } + + self._show_deploy_wait_msg(id, wait_min) + waiter.wait(deploymentId=id, WaiterConfig=config) + + def _show_deploy_wait_msg(self, id, wait_min): + sys.stdout.write( + self.MSG_WAITING.format(deployment_id=id, + wait=wait_min)) + sys.stdout.flush() class CodeDeployValidator(): @@ -300,6 +338,26 @@ def describe_cd_resources(self): raise exceptions.ServiceClientError( action='describe Code Deploy deployment group', error=e) + def get_deployment_wait_time(self): + + if (not hasattr(self, 'deployment_group_details') or + self.deployment_group_details is None): + return None + else: + dgp_info = self.deployment_group_details['deploymentGroupInfo'] + blue_green_info = dgp_info['blueGreenDeploymentConfiguration'] + + deploy_ready_wait_min = \ + blue_green_info['deploymentReadyOption']['waitTimeInMinutes'] + + terminate_key = 'terminateBlueInstancesOnDeploymentSuccess' + termination_wait_min = \ + blue_green_info[terminate_key]['terminationWaitTimeInMinutes'] + + configured_wait = deploy_ready_wait_min + termination_wait_min + + return configured_wait + TIMEOUT_BUFFER_MIN + def validate_all(self): self.validate_application() self.validate_deployment_group() diff --git a/bin/awscli/customizations/ecs/deploy.pyc b/bin/awscli/customizations/ecs/deploy.pyc deleted file mode 100644 index 1844f22a..00000000 Binary files a/bin/awscli/customizations/ecs/deploy.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ecs/exceptions.pyc b/bin/awscli/customizations/ecs/exceptions.pyc deleted file mode 100644 index 63258e7b..00000000 Binary files a/bin/awscli/customizations/ecs/exceptions.pyc and /dev/null differ diff --git a/bin/awscli/customizations/ecs/filehelpers.py b/bin/awscli/customizations/ecs/filehelpers.py index c3b02358..4001af70 100644 --- a/bin/awscli/customizations/ecs/filehelpers.py +++ b/bin/awscli/customizations/ecs/filehelpers.py @@ -78,4 +78,4 @@ def parse_appspec(appspec_str): try: return json.loads(appspec_str) except ValueError: - return yaml.load(appspec_str) + return yaml.safe_load(appspec_str) diff --git a/bin/awscli/customizations/ecs/filehelpers.pyc b/bin/awscli/customizations/ecs/filehelpers.pyc deleted file mode 100644 index 623d3f21..00000000 Binary files a/bin/awscli/customizations/ecs/filehelpers.pyc and /dev/null differ diff --git a/bin/awscli/customizations/eks/__init__.py b/bin/awscli/customizations/eks/__init__.py index 61eaaa73..9f3114a6 100644 --- a/bin/awscli/customizations/eks/__init__.py +++ b/bin/awscli/customizations/eks/__init__.py @@ -12,6 +12,7 @@ # language governing permissions and limitations under the License. from awscli.customizations.eks.update_kubeconfig import UpdateKubeconfigCommand +from awscli.customizations.eks.get_token import GetTokenCommand def initialize(cli): @@ -27,3 +28,4 @@ def inject_commands(command_table, session, **kwargs): Used to inject new high level commands into the command list. """ command_table['update-kubeconfig'] = UpdateKubeconfigCommand(session) + command_table['get-token'] = GetTokenCommand(session) diff --git a/bin/awscli/customizations/eks/__init__.pyc b/bin/awscli/customizations/eks/__init__.pyc deleted file mode 100644 index 7e5b36ef..00000000 Binary files a/bin/awscli/customizations/eks/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/eks/exceptions.pyc b/bin/awscli/customizations/eks/exceptions.pyc deleted file mode 100644 index 48a1a5b0..00000000 Binary files a/bin/awscli/customizations/eks/exceptions.pyc and /dev/null differ diff --git a/bin/awscli/customizations/eks/get_token.py b/bin/awscli/customizations/eks/get_token.py new file mode 100644 index 00000000..8594be57 --- /dev/null +++ b/bin/awscli/customizations/eks/get_token.py @@ -0,0 +1,151 @@ +# Copyright 2019 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 botocore +import json + +from botocore import session +from botocore.signers import RequestSigner +from botocore.model import ServiceId + +from awscli.customizations.commands import BasicCommand +from awscli.customizations.utils import uni_print + +AUTH_SERVICE = "sts" +AUTH_COMMAND = "GetCallerIdentity" +AUTH_API_VERSION = "2011-06-15" +AUTH_SIGNING_VERSION = "v4" + +# Presigned url timeout in seconds +URL_TIMEOUT = 60 + +TOKEN_PREFIX = 'k8s-aws-v1.' + +CLUSTER_NAME_HEADER = 'x-k8s-aws-id' + + +class GetTokenCommand(BasicCommand): + NAME = 'get-token' + + DESCRIPTION = ("Get a token for authentication with an Amazon EKS cluster. " + "This can be used as an alternative to the " + "aws-iam-authenticator.") + + ARG_TABLE = [ + { + 'name': 'cluster-name', + 'help_text': ("Specify the name of the Amazon EKS cluster to create a token for."), + 'required': True + }, + { + 'name': 'role-arn', + 'help_text': ("Assume this role for credentials when signing the token."), + 'required': False + } + ] + + def _run_main(self, parsed_args, parsed_globals): + token_generator = TokenGenerator(parsed_globals.region) + token = token_generator.get_token( + parsed_args.cluster_name, + parsed_args.role_arn + ) + + full_object = { + "kind": "ExecCredential", + "apiVersion": "client.authentication.k8s.io/v1alpha1", + "spec": {}, + "status": { + "token": token + } + } + + uni_print(json.dumps(full_object)) + uni_print('\n') + +class TokenGenerator(object): + def __init__(self, region_name, session_handler=None): + if session_handler is None: + session_handler = SessionHandler() + self._session_handler = session_handler + self._region_name = region_name + + def get_token(self, cluster_name, role_arn): + """ Generate a presigned url token to pass to kubectl. """ + url = self._get_presigned_url(cluster_name, role_arn) + token = TOKEN_PREFIX + base64.urlsafe_b64encode(url.encode('utf-8')).decode('utf-8').rstrip('=') + return token + + def _get_presigned_url(self, cluster_name, role_arn): + session = self._session_handler.get_session( + self._region_name, + role_arn + ) + + if self._region_name is None: + self._region_name = session.get_config_variable('region') + + loader = botocore.loaders.create_loader() + data = loader.load_data("endpoints") + endpoint_resolver = botocore.regions.EndpointResolver(data) + endpoint = endpoint_resolver.construct_endpoint( + AUTH_SERVICE, + self._region_name + ) + signer = RequestSigner( + ServiceId(AUTH_SERVICE), + self._region_name, + AUTH_SERVICE, + AUTH_SIGNING_VERSION, + session.get_credentials(), + session.get_component('event_emitter') + ) + action_params='Action=' + AUTH_COMMAND + '&Version=' + AUTH_API_VERSION + params = { + 'method': 'GET', + 'url': 'https://' + endpoint["hostname"] + '/?' + action_params, + 'body': {}, + 'headers': {CLUSTER_NAME_HEADER: cluster_name}, + 'context': {} + } + + url=signer.generate_presigned_url( + params, + region_name=endpoint["credentialScope"]["region"], + operation_name='', + expires_in=URL_TIMEOUT + ) + return url + +class SessionHandler(object): + def get_session(self, region_name, role_arn): + """ + Assumes the given role and returns a session object assuming said role. + """ + session = botocore.session.get_session() + if region_name is not None: + session.set_config_variable('region', region_name) + + if role_arn is not None: + sts = session.create_client(AUTH_SERVICE, region_name=region_name) + credentials_dict = sts.assume_role( + RoleArn=role_arn, + RoleSessionName='EKSGetTokenAuth' + )['Credentials'] + + session.set_credentials(credentials_dict['AccessKeyId'], + credentials_dict['SecretAccessKey'], + credentials_dict['SessionToken']) + return session + else: + return session diff --git a/bin/awscli/customizations/eks/kubeconfig.py b/bin/awscli/customizations/eks/kubeconfig.py index ba562907..2b221a38 100644 --- a/bin/awscli/customizations/eks/kubeconfig.py +++ b/bin/awscli/customizations/eks/kubeconfig.py @@ -229,17 +229,17 @@ def insert_entry(self, config, key, entry): config.content[key] = array return config - def _make_context(self, cluster, user): - """ Generate a context to associate cluster and user.""" + def _make_context(self, cluster, user, alias=None): + """ Generate a context to associate cluster and user with a given alias.""" return OrderedDict([ ("context", OrderedDict([ ("cluster", cluster["name"]), ("user", user["name"]) ])), - ("name", user["name"]) + ("name", alias or user["name"]) ]) - def insert_cluster_user_pair(self, config, cluster, user): + def insert_cluster_user_pair(self, config, cluster, user, alias=None): """ Insert the passed cluster entry and user entry, then make a context to associate them @@ -255,10 +255,13 @@ def insert_cluster_user_pair(self, config, cluster, user): :param user: the user entry :type user: OrderedDict + :param alias: the alias for the context; defaults top user entry name + :type context: str + :return: The generated context :rtype: OrderedDict """ - context = self._make_context(cluster, user) + context = self._make_context(cluster, user, alias=alias) self.insert_entry(config, "clusters", cluster) self.insert_entry(config, "users", user) self.insert_entry(config, "contexts", context) diff --git a/bin/awscli/customizations/eks/kubeconfig.pyc b/bin/awscli/customizations/eks/kubeconfig.pyc deleted file mode 100644 index 94d9ebba..00000000 Binary files a/bin/awscli/customizations/eks/kubeconfig.pyc and /dev/null differ diff --git a/bin/awscli/customizations/eks/ordered_yaml.pyc b/bin/awscli/customizations/eks/ordered_yaml.pyc deleted file mode 100644 index 364bf2d4..00000000 Binary files a/bin/awscli/customizations/eks/ordered_yaml.pyc and /dev/null differ diff --git a/bin/awscli/customizations/eks/update_kubeconfig.py b/bin/awscli/customizations/eks/update_kubeconfig.py index 3d7b0407..0dad708b 100644 --- a/bin/awscli/customizations/eks/update_kubeconfig.py +++ b/bin/awscli/customizations/eks/update_kubeconfig.py @@ -18,8 +18,6 @@ from awscli.customizations.commands import BasicCommand from awscli.customizations.utils import uni_print -from awscli.compat import is_windows -from awscli.compat import which from awscli.customizations.eks.exceptions import EKSClusterError from awscli.customizations.eks.kubeconfig import (Kubeconfig, KubeconfigError, @@ -38,31 +36,6 @@ # Do a check on the cluster's version number API_VERSION = "client.authentication.k8s.io/v1alpha1" -AUTH_BIN = "aws-iam-authenticator" - -AUTH_GOGET_PATH = ("github.com/kubernetes-sigs/" - "aws-iam-authenticator/cmd/aws-iam-authenticator") - - -def check_for_binary(binary): - return which(binary) is not None - -def warn_of_missing_dependencies(): - """ - Check the dependencies of the kubectl configuration generated by - update-kubeconfig to see if any are missing. - If they are missing, print a warning with information on how to download - the missing dependency - - Currently dependent on: - aws-iam-authenticator - """ - if not check_for_binary(AUTH_BIN): - uni_print("Warning: {0} is not installed properly or is not in your path.\n" - "Refer to the AWS Documentation to download it at " - "https://docs.aws.amazon.com/eks/latest/userguide/configure-kubectl.html\n".format(AUTH_BIN)) - - class UpdateKubeconfigCommand(BasicCommand): NAME = 'update-kubeconfig' @@ -118,11 +91,17 @@ class UpdateKubeconfigCommand(BasicCommand): 'help_text': ("Print more detailed output " "when writing to the kubeconfig file, " "including the appended entries.") + }, + { + 'name': 'alias', + 'help_text': ("Alias for the cluster context name. " + "Defaults to match cluster ARN."), + 'required': False } ] def _display_entries(self, entries): - """ + """ Display entries in yaml format :param entries: a list of OrderedDicts to be printed @@ -152,7 +131,8 @@ def _run_main(self, parsed_args, parsed_globals): appender = KubeconfigAppender() new_context_dict = appender.insert_cluster_user_pair(config, new_cluster_dict, - new_user_dict) + new_user_dict, + parsed_args.alias) if parsed_args.dry_run: uni_print(config.dump_content()) @@ -176,7 +156,6 @@ def _run_main(self, parsed_args, parsed_globals): new_cluster_dict ]) - warn_of_missing_dependencies() class KubeconfigSelector(object): @@ -269,7 +248,7 @@ def _get_cluster_description(self): client = self._session.create_client("eks") else: client = self._session.create_client( - "eks", + "eks", region_name=self._globals.region, endpoint_url=self._globals.endpoint_url, verify=self._globals.verify_ssl @@ -308,6 +287,9 @@ def get_user_entry(self): Return a user entry generated using the previously obtained description. """ + + region = self._get_cluster_description().get("arn").split(":")[3] + generated_user = OrderedDict([ ("name", self._get_cluster_description().get("arn", "")), ("user", OrderedDict([ @@ -315,22 +297,28 @@ def get_user_entry(self): ("apiVersion", API_VERSION), ("args", [ - "token", - "-i", - self._cluster_name + "--region", + region, + "eks", + "get-token", + "--cluster-name", + self._cluster_name, ]), - ("command", AUTH_BIN) + ("command", "aws") ])) ])) ]) - if is_windows: - generated_user["user"]["exec"]["command"] += ".exe" - if self._role_arn is not None: generated_user["user"]["exec"]["args"].extend([ - "-r", + "--role", self._role_arn ]) + if self._session.profile: + generated_user["user"]["exec"]["env"] = [OrderedDict([ + ("name", "AWS_PROFILE"), + ("value", self._session.profile) + ])] + return generated_user diff --git a/bin/awscli/customizations/eks/update_kubeconfig.pyc b/bin/awscli/customizations/eks/update_kubeconfig.pyc deleted file mode 100644 index 8f7e7f74..00000000 Binary files a/bin/awscli/customizations/eks/update_kubeconfig.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/__init__.pyc b/bin/awscli/customizations/emr/__init__.pyc deleted file mode 100644 index 653467f8..00000000 Binary files a/bin/awscli/customizations/emr/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/addinstancegroups.pyc b/bin/awscli/customizations/emr/addinstancegroups.pyc deleted file mode 100644 index d54ee42c..00000000 Binary files a/bin/awscli/customizations/emr/addinstancegroups.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/addsteps.pyc b/bin/awscli/customizations/emr/addsteps.pyc deleted file mode 100644 index 7f1adec8..00000000 Binary files a/bin/awscli/customizations/emr/addsteps.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/addtags.pyc b/bin/awscli/customizations/emr/addtags.pyc deleted file mode 100644 index 116d9e81..00000000 Binary files a/bin/awscli/customizations/emr/addtags.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/applicationutils.pyc b/bin/awscli/customizations/emr/applicationutils.pyc deleted file mode 100644 index 25e65708..00000000 Binary files a/bin/awscli/customizations/emr/applicationutils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/argumentschema.py b/bin/awscli/customizations/emr/argumentschema.py index 4e491865..e1806368 100644 --- a/bin/awscli/customizations/emr/argumentschema.py +++ b/bin/awscli/customizations/emr/argumentschema.py @@ -14,6 +14,48 @@ from awscli.customizations.emr import helptext from awscli.customizations.emr.createdefaultroles import EC2_ROLE_NAME +CONFIGURATIONS_PROPERTIES_SCHEMA = { + "type": "map", + "key": { + "type": "string", + "description": "Configuration key" + }, + "value": { + "type": "string", + "description": "Configuration value" + }, + "description": "Application configuration properties" +} + +CONFIGURATIONS_CLASSIFICATION_SCHEMA = { + "type": "string", + "description": "Application configuration classification name", +} + +INNER_CONFIGURATIONS_SCHEMA = { + "type": "array", + "items": { + "type": "object", + "properties": { + "Classification": CONFIGURATIONS_CLASSIFICATION_SCHEMA, + "Properties": CONFIGURATIONS_PROPERTIES_SCHEMA + } + }, + "description": "Instance group application configurations." +} + +OUTER_CONFIGURATIONS_SCHEMA = { + "type": "array", + "items": { + "type": "object", + "properties": { + "Classification": CONFIGURATIONS_CLASSIFICATION_SCHEMA, + "Properties": CONFIGURATIONS_PROPERTIES_SCHEMA, + "Configurations": INNER_CONFIGURATIONS_SCHEMA + } + }, + "description": "Instance group application configurations." +} INSTANCE_GROUPS_SCHEMA = { "type": "array", @@ -236,7 +278,8 @@ } } } - } + }, + "Configurations": OUTER_CONFIGURATIONS_SCHEMA } } } @@ -336,12 +379,7 @@ } } }, - - "Configurations": { - "type": "string", - "description": - "Additional configiration data." - } + "Configurations": OUTER_CONFIGURATIONS_SCHEMA } } }, diff --git a/bin/awscli/customizations/emr/argumentschema.pyc b/bin/awscli/customizations/emr/argumentschema.pyc deleted file mode 100644 index 775b8229..00000000 Binary files a/bin/awscli/customizations/emr/argumentschema.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/command.pyc b/bin/awscli/customizations/emr/command.pyc deleted file mode 100644 index 9209ac79..00000000 Binary files a/bin/awscli/customizations/emr/command.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/config.pyc b/bin/awscli/customizations/emr/config.pyc deleted file mode 100644 index 54324dc2..00000000 Binary files a/bin/awscli/customizations/emr/config.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/configutils.pyc b/bin/awscli/customizations/emr/configutils.pyc deleted file mode 100644 index b5b2a0ad..00000000 Binary files a/bin/awscli/customizations/emr/configutils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/constants.pyc b/bin/awscli/customizations/emr/constants.pyc deleted file mode 100644 index 42425e6e..00000000 Binary files a/bin/awscli/customizations/emr/constants.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/createcluster.py b/bin/awscli/customizations/emr/createcluster.py index ef4abfe8..8a92c0b8 100644 --- a/bin/awscli/customizations/emr/createcluster.py +++ b/bin/awscli/customizations/emr/createcluster.py @@ -119,7 +119,7 @@ class CreateCluster(Command): 'schema': argumentschema.KERBEROS_ATTRIBUTES_SCHEMA, 'help_text': helptext.KERBEROS_ATTRIBUTES} ] - SYNOPSIS = BasicCommand.FROM_FILE('emr', 'create-cluster-synopsis.rst') + SYNOPSIS = BasicCommand.FROM_FILE('emr', 'create-cluster-synopsis.txt') EXAMPLES = BasicCommand.FROM_FILE('emr', 'create-cluster-examples.rst') def _run_main_command(self, parsed_args, parsed_globals): diff --git a/bin/awscli/customizations/emr/createcluster.pyc b/bin/awscli/customizations/emr/createcluster.pyc deleted file mode 100644 index 20af5ac1..00000000 Binary files a/bin/awscli/customizations/emr/createcluster.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/createdefaultroles.pyc b/bin/awscli/customizations/emr/createdefaultroles.pyc deleted file mode 100644 index bb18bbdb..00000000 Binary files a/bin/awscli/customizations/emr/createdefaultroles.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/describecluster.pyc b/bin/awscli/customizations/emr/describecluster.pyc deleted file mode 100644 index eb444491..00000000 Binary files a/bin/awscli/customizations/emr/describecluster.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/emr.pyc b/bin/awscli/customizations/emr/emr.pyc deleted file mode 100644 index 27f3faf6..00000000 Binary files a/bin/awscli/customizations/emr/emr.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/emrfsutils.pyc b/bin/awscli/customizations/emr/emrfsutils.pyc deleted file mode 100644 index e0ad89ec..00000000 Binary files a/bin/awscli/customizations/emr/emrfsutils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/emrutils.pyc b/bin/awscli/customizations/emr/emrutils.pyc deleted file mode 100644 index 031f68e5..00000000 Binary files a/bin/awscli/customizations/emr/emrutils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/exceptions.pyc b/bin/awscli/customizations/emr/exceptions.pyc deleted file mode 100644 index 70585350..00000000 Binary files a/bin/awscli/customizations/emr/exceptions.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/hbase.pyc b/bin/awscli/customizations/emr/hbase.pyc deleted file mode 100644 index 610039e0..00000000 Binary files a/bin/awscli/customizations/emr/hbase.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/hbaseutils.pyc b/bin/awscli/customizations/emr/hbaseutils.pyc deleted file mode 100644 index f9cace3c..00000000 Binary files a/bin/awscli/customizations/emr/hbaseutils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/helptext.pyc b/bin/awscli/customizations/emr/helptext.pyc deleted file mode 100644 index 88c4a19a..00000000 Binary files a/bin/awscli/customizations/emr/helptext.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/installapplications.pyc b/bin/awscli/customizations/emr/installapplications.pyc deleted file mode 100644 index b0be70ba..00000000 Binary files a/bin/awscli/customizations/emr/installapplications.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/instancefleetsutils.pyc b/bin/awscli/customizations/emr/instancefleetsutils.pyc deleted file mode 100644 index a168ffaa..00000000 Binary files a/bin/awscli/customizations/emr/instancefleetsutils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/instancegroupsutils.py b/bin/awscli/customizations/emr/instancegroupsutils.py index fe4ff998..e1707643 100644 --- a/bin/awscli/customizations/emr/instancegroupsutils.py +++ b/bin/awscli/customizations/emr/instancegroupsutils.py @@ -46,6 +46,9 @@ def build_instance_groups(parsed_instance_groups): if 'AutoScalingPolicy' in keys: ig_config['AutoScalingPolicy'] = instance_group['AutoScalingPolicy'] + if 'Configurations' in keys: + ig_config['Configurations'] = instance_group['Configurations'] + instance_groups.append(ig_config) return instance_groups diff --git a/bin/awscli/customizations/emr/instancegroupsutils.pyc b/bin/awscli/customizations/emr/instancegroupsutils.pyc deleted file mode 100644 index 6ef26eae..00000000 Binary files a/bin/awscli/customizations/emr/instancegroupsutils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/listclusters.pyc b/bin/awscli/customizations/emr/listclusters.pyc deleted file mode 100644 index 940398b7..00000000 Binary files a/bin/awscli/customizations/emr/listclusters.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/modifyclusterattributes.pyc b/bin/awscli/customizations/emr/modifyclusterattributes.pyc deleted file mode 100644 index 0cae0665..00000000 Binary files a/bin/awscli/customizations/emr/modifyclusterattributes.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/ssh.pyc b/bin/awscli/customizations/emr/ssh.pyc deleted file mode 100644 index 149aad78..00000000 Binary files a/bin/awscli/customizations/emr/ssh.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/sshutils.pyc b/bin/awscli/customizations/emr/sshutils.pyc deleted file mode 100644 index 32d422ec..00000000 Binary files a/bin/awscli/customizations/emr/sshutils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/steputils.pyc b/bin/awscli/customizations/emr/steputils.pyc deleted file mode 100644 index 62e7cebd..00000000 Binary files a/bin/awscli/customizations/emr/steputils.pyc and /dev/null differ diff --git a/bin/awscli/customizations/emr/terminateclusters.pyc b/bin/awscli/customizations/emr/terminateclusters.pyc deleted file mode 100644 index 762eab68..00000000 Binary files a/bin/awscli/customizations/emr/terminateclusters.pyc and /dev/null differ diff --git a/bin/awscli/customizations/flatten.pyc b/bin/awscli/customizations/flatten.pyc deleted file mode 100644 index eea97773..00000000 Binary files a/bin/awscli/customizations/flatten.pyc and /dev/null differ diff --git a/bin/awscli/customizations/gamelift/__init__.pyc b/bin/awscli/customizations/gamelift/__init__.pyc deleted file mode 100644 index 24e78e82..00000000 Binary files a/bin/awscli/customizations/gamelift/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/gamelift/getlog.pyc b/bin/awscli/customizations/gamelift/getlog.pyc deleted file mode 100644 index 68920b4c..00000000 Binary files a/bin/awscli/customizations/gamelift/getlog.pyc and /dev/null differ diff --git a/bin/awscli/customizations/gamelift/uploadbuild.pyc b/bin/awscli/customizations/gamelift/uploadbuild.pyc deleted file mode 100644 index c93f753a..00000000 Binary files a/bin/awscli/customizations/gamelift/uploadbuild.pyc and /dev/null differ diff --git a/bin/awscli/customizations/generatecliskeleton.pyc b/bin/awscli/customizations/generatecliskeleton.pyc deleted file mode 100644 index d5295f6a..00000000 Binary files a/bin/awscli/customizations/generatecliskeleton.pyc and /dev/null differ diff --git a/bin/awscli/customizations/globalargs.pyc b/bin/awscli/customizations/globalargs.pyc deleted file mode 100644 index 71badd9b..00000000 Binary files a/bin/awscli/customizations/globalargs.pyc and /dev/null differ diff --git a/bin/awscli/customizations/history/__init__.pyc b/bin/awscli/customizations/history/__init__.pyc deleted file mode 100644 index 53509d0e..00000000 Binary files a/bin/awscli/customizations/history/__init__.pyc and /dev/null differ diff --git a/bin/awscli/customizations/history/commands.pyc b/bin/awscli/customizations/history/commands.pyc deleted file mode 100644 index 7ab656b7..00000000 Binary files a/bin/awscli/customizations/history/commands.pyc and /dev/null differ diff --git a/bin/awscli/customizations/history/constants.pyc b/bin/awscli/customizations/history/constants.pyc deleted file mode 100644 index de633710..00000000 Binary files a/bin/awscli/customizations/history/constants.pyc and /dev/null differ diff --git a/bin/awscli/customizations/history/db.pyc b/bin/awscli/customizations/history/db.pyc deleted file mode 100644 index 8cd27e0c..00000000 Binary files a/bin/awscli/customizations/history/db.pyc and /dev/null differ diff --git a/bin/awscli/customizations/history/filters.pyc b/bin/awscli/customizations/history/filters.pyc deleted file mode 100644 index 50f6ab7b..00000000 Binary files a/bin/awscli/customizations/history/filters.pyc and /dev/null differ diff --git a/bin/awscli/customizations/history/list.pyc b/bin/awscli/customizations/history/list.pyc deleted file mode 100644 index 94d8d477..00000000 Binary files a/bin/awscli/customizations/history/list.pyc and /dev/null differ diff --git a/bin/awscli/customizations/history/show.pyc b/bin/awscli/customizations/history/show.pyc deleted file mode 100644 index 9e1ca3ff..00000000 Binary files a/bin/awscli/customizations/history/show.pyc and /dev/null differ diff --git a/bin/awscli/customizations/iamvirtmfa.pyc b/bin/awscli/customizations/iamvirtmfa.pyc deleted file mode 100644 index b469cb12..00000000 Binary files a/bin/awscli/customizations/iamvirtmfa.pyc and /dev/null differ diff --git a/bin/awscli/customizations/iot.pyc b/bin/awscli/customizations/iot.pyc deleted file mode 100644 index a3871588..00000000 Binary files a/bin/awscli/customizations/iot.pyc and /dev/null differ diff --git a/bin/awscli/customizations/iot_data.pyc b/bin/awscli/customizations/iot_data.pyc deleted file mode 100644 index 0b6ad6c9..00000000 Binary files a/bin/awscli/customizations/iot_data.pyc and /dev/null differ diff --git a/bin/awscli/customizations/kms.pyc b/bin/awscli/customizations/kms.pyc deleted file mode 100644 index 100997f0..00000000 Binary files a/bin/awscli/customizations/kms.pyc and /dev/null differ diff --git a/bin/awscli/customizations/mturk.pyc b/bin/awscli/customizations/mturk.pyc deleted file mode 100644 index fe96a07a..00000000 Binary files a/bin/awscli/customizations/mturk.pyc and /dev/null differ diff --git a/bin/awscli/customizations/opsworks.py b/bin/awscli/customizations/opsworks.py index bab21ce1..91048a5f 100644 --- a/bin/awscli/customizations/opsworks.py +++ b/bin/awscli/customizations/opsworks.py @@ -34,6 +34,7 @@ IAM_USER_POLICY_NAME = "OpsWorks-Instance" IAM_USER_POLICY_TIMEOUT = datetime.timedelta(minutes=15) IAM_PATH = '/AWS/OpsWorks/' +IAM_POLICY_ARN = 'arn:aws:iam::aws:policy/AWSOpsWorksInstanceRegistration' HOSTNAME_RE = re.compile(r"^(?!-)[a-z0-9-]{1,63}(?`_ in the *Amazon API Gateway Developer Guide*. diff --git a/bin/awscli/examples/apigatewayv2/create-api.rst b/bin/awscli/examples/apigatewayv2/create-api.rst new file mode 100644 index 00000000..f94755fd --- /dev/null +++ b/bin/awscli/examples/apigatewayv2/create-api.rst @@ -0,0 +1,21 @@ +**To create a WebSocket API** + +The following ``create-api`` example creates a WebSocket API with the specified name. :: + + aws apigatewayv2 create-api \ + --name "myWebSocketApi" \ + --protocol-type WEBSOCKET \ + --route-selection-expression '$request.body.action' + +Output:: + + { + "ApiKeySelectionExpression": "$request.header.x-api-key", + "Name": "myWebSocketApi", + "CreatedDate": "2018-11-15T06:23:51Z", + "ProtocolType": "WEBSOCKET", + "RouteSelectionExpression": "'$request.body.action'", + "ApiId": "aabbccddee" + } + +For more information, see `Create a WebSocket API in API Gateway `_ in the *Amazon API Gateway Developer Guide*. diff --git a/bin/awscli/examples/apigatewayv2/create-integration.rst b/bin/awscli/examples/apigatewayv2/create-integration.rst new file mode 100644 index 00000000..9dcfc5dc --- /dev/null +++ b/bin/awscli/examples/apigatewayv2/create-integration.rst @@ -0,0 +1,27 @@ +**To create a WebSocket API Integration Request** + +The following ``create-integration`` requests an integration for a WebSocket API. :: + + aws apigatewayv2 create-integration \ + --api-id aabbccddee \ + --passthrough-behavior WHEN_NO_MATCH \ + --timeout-in-millis 29000 \ + --connection-type INTERNET + --request-templates "{\"application/json\": \"{\"statusCode\":200}\"}" + --integration-type MOCK + +Output:: + + { + "PassthroughBehavior": "WHEN_NO_MATCH", + "TimeoutInMillis": 29000, + "ConnectionType": "INTERNET", + "IntegrationResponseSelectionExpression": "${response.statuscode}", + "RequestTemplates": { + "application/json": "{"statusCode":200}" + }, + "IntegrationId": "0abcdef", + "IntegrationType": "MOCK" + } + +For more information, see `Set up a WebSocket API Integration Request in API Gateway `_ in the *Amazon API Gateway Developer Guide*. diff --git a/bin/awscli/examples/apigatewayv2/create-route.rst b/bin/awscli/examples/apigatewayv2/create-route.rst new file mode 100644 index 00000000..901bcefb --- /dev/null +++ b/bin/awscli/examples/apigatewayv2/create-route.rst @@ -0,0 +1,18 @@ +**To create a route for a WebSocket API** + +The following ``create-route`` example creates a route for a WebSocket API. :: + + aws apigatewayv2 create-route \ + --api-id aabbccddee \ + --route-key $default + +Output:: + + { + "ApiKeyRequired": false, + "AuthorizationType": "NONE", + "RouteKey": "$default", + "RouteId": "1122334" + } + +For more information, see `Set up Routes for a WebSocket API in API Gateway `_ in the *Amazon API Gateway Developer Guide* diff --git a/bin/awscli/examples/application-autoscaling/deregister-scalable-target.rst b/bin/awscli/examples/application-autoscaling/deregister-scalable-target.rst index 008386f4..e018263f 100644 --- a/bin/awscli/examples/application-autoscaling/deregister-scalable-target.rst +++ b/bin/awscli/examples/application-autoscaling/deregister-scalable-target.rst @@ -5,3 +5,13 @@ This example deregisters a scalable target for an Amazon ECS service called `web Command:: aws application-autoscaling deregister-scalable-target --service-namespace ecs --scalable-dimension ecs:service:DesiredCount --resource-id service/default/web-app + +This example deregisters a scalable target for a custom resource. The custom-resource-id.txt file contains a string that identifies the Resource ID, which, for a custom resource, is the path to the custom resource through your Amazon API Gateway endpoint. + +Command:: + + aws application-autoscaling deregister-scalable-target --service-namespace custom-resource --scalable-dimension custom-resource:ResourceType:Property --resource-id file://~/custom-resource-id.txt + +Contents of custom-resource-id.txt file:: + + https://example.execute-api.us-west-2.amazonaws.com/prod/scalableTargetDimensions/1-23456789 diff --git a/bin/awscli/examples/application-autoscaling/put-scaling-policy.rst b/bin/awscli/examples/application-autoscaling/put-scaling-policy.rst old mode 100644 new mode 100755 index 5233bacf..a02869e6 --- a/bin/awscli/examples/application-autoscaling/put-scaling-policy.rst +++ b/bin/awscli/examples/application-autoscaling/put-scaling-policy.rst @@ -1,33 +1,85 @@ -**To apply a scaling policy to an Amazon ECS service** - -This example command 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. - -Command:: - - aws application-autoscaling put-scaling-policy --cli-input-json file://scale-out.json - -Contents of `scale-out.json` file:: - - { - "PolicyName": "web-app-cpu-gt-75", - "ServiceNamespace": "ecs", - "ResourceId": "service/default/web-app", - "ScalableDimension": "ecs:service:DesiredCount", - "PolicyType": "StepScaling", - "StepScalingPolicyConfiguration": { - "AdjustmentType": "PercentChangeInCapacity", - "StepAdjustments": [ - { - "MetricIntervalLowerBound": 0, - "ScalingAdjustment": 200 - } - ], - "Cooldown": 60 - } - } +**Example 1: To apply a target tracking scaling policy with a predefined metric specification** + +The following ``put-scaling-policy`` example applies a target tracking scaling policy with a predefined metric specification to an Amazon ECS service called web-app in the default cluster. The policy keeps the average CPU utilization of the service at 75 percent, with scale-out and scale-in cooldown periods of 60 seconds. The output contains the ARNs and names of the two CloudWatch alarms created on your behalf. :: + + aws application-autoscaling put-scaling-policy --service-namespace ecs \ + --scalable-dimension ecs:service:DesiredCount \ + --resource-id service/default/web-app \ + --policy-name cpu75-target-tracking-scaling-policy --policy-type TargetTrackingScaling \ + --target-tracking-scaling-policy-configuration file://config.json + +This example assumes that you have a `config.json` file in the current directory with the following contents:: + + { + "TargetValue": 75.0, + "PredefinedMetricSpecification": { + "PredefinedMetricType": "ECSServiceAverageCPUUtilization" + }, + "ScaleOutCooldown": 60, + "ScaleInCooldown": 60 + } 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" - } + { + "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/cpu75-target-tracking-scaling-policy", + "Alarms": [ + { + "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca", + "AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca" + }, + { + "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmLow-1b437334-d19b-4a63-a812-6c67aaf2910d", + "AlarmName": "TargetTracking-service/default/web-app-AlarmLow-1b437334-d19b-4a63-a812-6c67aaf2910d" + } + ] + } + +**Example 2: To apply a target tracking scaling policy with a customized metric specification** + +The following ``put-scaling-policy`` example applies a target tracking scaling policy with a customized metric specification to an Amazon ECS service called web-app in the default cluster. The policy keeps the average utilization of the service at 75 percent, with scale-out and scale-in cooldown periods of 60 seconds. The output contains the ARNs and names of the two CloudWatch alarms created on your behalf. :: + + aws application-autoscaling put-scaling-policy --service-namespace ecs \ + --scalable-dimension ecs:service:DesiredCount \ + --resource-id service/default/web-app \ + --policy-name cms75-target-tracking-scaling-policy + --policy-type TargetTrackingScaling \ + --target-tracking-scaling-policy-configuration file://config.json + +This example assumes that you have a `config.json` file in the current directory with the following contents:: + + { + "TargetValue":75.0, + "CustomizedMetricSpecification":{ + "MetricName":"MyUtilizationMetric", + "Namespace":"MyNamespace", + "Dimensions": [ + { + "Name":"MyOptionalMetricDimensionName", + "Value":"MyOptionalMetricDimensionValue" + } + ], + "Statistic":"Average", + "Unit":"Percent" + }, + "ScaleOutCooldown": 60, + "ScaleInCooldown": 60 + } + +Output:: + + { + "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy: 8784a896-b2ba-47a1-b08c-27301cc499a1:resource/ecs/service/default/web-app:policyName/cms75-target-tracking-scaling-policy", + "Alarms": [ + { + "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmHigh-9bc77b56-0571-4276-ba0f-d4178882e0a0", + "AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-9bc77b56-0571-4276-ba0f-d4178882e0a0" + }, + { + "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmLow-9b6ad934-6d37-438e-9e05-02836ddcbdc4", + "AlarmName": "TargetTracking-service/default/web-app-AlarmLow-9b6ad934-6d37-438e-9e05-02836ddcbdc4" + } + ] + } + +For more information, see `Target Tracking Scaling Policies for Application Auto Scaling `_ in the *AWS Application Auto Scaling User Guide*. diff --git a/bin/awscli/examples/application-autoscaling/put-scheduled-action.rst b/bin/awscli/examples/application-autoscaling/put-scheduled-action.rst new file mode 100644 index 00000000..d82d7444 --- /dev/null +++ b/bin/awscli/examples/application-autoscaling/put-scheduled-action.rst @@ -0,0 +1,11 @@ +**To add a scheduled action to a DynamoDB table** + +This example adds a scheduled action to a DynamoDB table called `TestTable` to scale out on a recurring schedule. On the specified schedule (every day at 12:15pm UTC), if the current capacity is below the value specified for MinCapacity, Application Auto Scaling scales out to the value specified by MinCapacity. + +Command:: + + aws application-autoscaling put-scheduled-action --service-namespace dynamodb --scheduled-action-name my-recurring-action --schedule "cron(15 12 * * ? *)" --resource-id table/TestTable --scalable-dimension dynamodb:table:WriteCapacityUnits --scalable-target-action MinCapacity=6 + +For more information, see `Scheduled Scaling`_ in the *Application Auto Scaling User Guide*. + +.. _`Scheduled Scaling`: https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-scheduled-scaling.html diff --git a/bin/awscli/examples/application-autoscaling/register-scalable-target.rst b/bin/awscli/examples/application-autoscaling/register-scalable-target.rst index 8a5917c3..028538c8 100644 --- a/bin/awscli/examples/application-autoscaling/register-scalable-target.rst +++ b/bin/awscli/examples/application-autoscaling/register-scalable-target.rst @@ -4,18 +4,54 @@ This example command registers a scalable target from an Amazon ECS service call Command:: - aws application-autoscaling register-scalable-target --resource-id service/default/web-app --service-namespace ecs --scalable-dimension ecs:service:DesiredCount --min-capacity 1 --max-capacity 10 --role-arn arn:aws:iam::012345678910:role/ApplicationAutoscalingECSRole - -Output:: - - { - "cluster": { - "status": "ACTIVE", - "clusterName": "my_cluster", - "registeredContainerInstancesCount": 0, - "pendingTasksCount": 0, - "runningTasksCount": 0, - "activeServicesCount": 0, - "clusterArn": "arn:aws:ecs:::cluster/my_cluster" - } - } + aws application-autoscaling register-scalable-target --service-namespace ecs --scalable-dimension ecs:service:DesiredCount --resource-id service/default/web-app --min-capacity 1 --max-capacity 10 + +This example command registers a scalable target from a Spot Fleet request using its request ID, with a minimum desired count of 2 instances and a maximum desired count of 10 instances. + +Command:: + + aws application-autoscaling register-scalable-target --service-namespace ec2 --scalable-dimension ec2:spot-fleet-request:TargetCapacity --resource-id spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE --min-capacity 2 --max-capacity 10 + +This example command registers a scalable target from an AppStream 2.0 fleet called `sample-fleet`, with a minimum desired count of 1 instance and a maximum desired count of 5 instances. + +Command:: + + aws application-autoscaling register-scalable-target --service-namespace appstream --scalable-dimension appstream:fleet:DesiredCapacity --resource-id fleet/sample-fleet --min-capacity 1 --max-capacity 5 + +This example command registers the write capacity of a DynamoDB table called `my-table` as a scalable target, with a minimum desired count of 5 write capacity units and a maximum desired count of 10 write capacity units. + +Command:: + + aws application-autoscaling register-scalable-target --service-namespace dynamodb --scalable-dimension dynamodb:table:WriteCapacityUnits --resource-id table/my-table --min-capacity 5 --max-capacity 10 + +This example command registers the write capacity of a DynamoDB global secondary index called `my-table-index` as a scalable target, with a minimum desired count of 5 write capacity units and a maximum desired count of 10 write capacity units. + +Command:: + + aws application-autoscaling register-scalable-target --service-namespace dynamodb --scalable-dimension dynamodb:index:WriteCapacityUnits --resource-id table/my-table/index/my-table-index --min-capacity 5 --max-capacity 10 + +This example command registers a scalable target from an Aurora DB cluster called `my-db-cluster`, with a minimum desired count of 1 Aurora Replica and a maximum desired count of 8 Aurora Replicas. + +Command:: + + aws application-autoscaling register-scalable-target --service-namespace rds --scalable-dimension rds:cluster:ReadReplicaCount --resource-id cluster:my-db-cluster --min-capacity 1 --max-capacity 8 + +This example command registers a scalable target from an Amazon Sagemaker product variant called `my-variant` running on the `my-endpoint` endpoint, with a minimum desired count of 1 instance and a maximum desired count of 8 instances. + +Command:: + + aws application-autoscaling register-scalable-target --service-namespace sagemaker --scalable-dimension sagemaker:variant:DesiredInstanceCount --resource-id endpoint/my-endpoint/variant/my-variant --min-capacity 1 --max-capacity 8 + +This example registers a custom resource as a scalable target, with a minimum desired count of 1 capacity unit and a maximum desired count of 10 capacity units. The custom-resource-id.txt file contains a string that identifies the Resource ID, which, for a custom resource, is the path to the custom resource through your Amazon API Gateway endpoint. + +Command:: + + aws application-autoscaling register-scalable-target --service-namespace custom-resource --scalable-dimension custom-resource:ResourceType:Property --resource-id file://~/custom-resource-id.txt --min-capacity 1 --max-capacity 10 + +Contents of custom-resource-id.txt file:: + + https://example.execute-api.us-west-2.amazonaws.com/prod/scalableTargetDimensions/1-23456789 + +For more information, see the `Application Auto Scaling User Guide`_. + +.. _`Application Auto Scaling User Guide`: https://docs.aws.amazon.com/autoscaling/application/userguide/what-is-application-auto-scaling.html diff --git a/bin/awscli/examples/autoscaling/create-auto-scaling-group.rst b/bin/awscli/examples/autoscaling/create-auto-scaling-group.rst index d39cf4c4..39d5780a 100644 --- a/bin/awscli/examples/autoscaling/create-auto-scaling-group.rst +++ b/bin/awscli/examples/autoscaling/create-auto-scaling-group.rst @@ -1,17 +1,68 @@ -**To create an Auto Scaling group** +**To create an Auto Scaling group using a launch configuration** -This example creates an Auto Scaling group in a VPC:: +This example creates an Auto Scaling group in a VPC using a launch configuration to specify the type of EC2 instance that Amazon EC2 Auto Scaling creates:: - aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-auto-scaling-group --launch-configuration-name my-launch-config --min-size 1 --max-size 3 --vpc-zone-identifier subnet-41767929c + aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg --launch-configuration-name my-launch-config --min-size 1 --max-size 3 --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" This example creates an Auto Scaling group and configures it to use an Elastic Load Balancing load balancer:: - aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-auto-scaling-group --launch-configuration-name my-launch-config --load-balancer-names my-load-balancer --health-check-type ELB --health-check-grace-period 120 + aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg --launch-configuration-name my-launch-config --load-balancer-names my-load-balancer --health-check-type ELB --health-check-grace-period 120 --min-size 1 --max-size 3 --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" -This example creates an Auto Scaling group. It specifies Availability Zones instead of subnets. It also launches instances into a placement group and sets the termination policy to terminate the oldest instances first:: +This example specifies a desired capacity as well as a minimum and maximum capacity. It also launches instances into a placement group and sets the termination policy to terminate the oldest instances first:: - aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-auto-scaling-group --launch-configuration-name my-launch-config --min-size 1 --max-size 3 --desired-capacity 2 --default-cooldown 600 --placement-group my-placement-group --termination-policies "OldestInstance" --availability-zones us-west-2c + aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg --launch-configuration-name my-launch-config --min-size 1 --max-size 3 --desired-capacity 1 --placement-group my-placement-group --termination-policies "OldestInstance" --availability-zones us-west-2c + +**To create an Auto Scaling group using an EC2 instance** This example creates an Auto Scaling group from the specified EC2 instance and assigns a tag to instances in the group:: - aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-auto-scaling-group --instance-id i-22c99e2a --min-size 1 --max-size 3 --vpc-zone-identifier subnet-41767929 --tags ResourceId=my-auto-scaling-group,ResourceType=auto-scaling-group,Key=Role,Value=WebServer + aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg --instance-id i-22c99e2a --min-size 1 --max-size 3 --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" --tags "ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Role,Value=WebServer,PropagateAtLaunch=true" + +**To create an Auto Scaling group using a launch template** + +This example creates an Auto Scaling group in a VPC using a launch template to specify the type of EC2 instance that Amazon EC2 Auto Scaling creates:: + + aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg --launch-template "LaunchTemplateName=my-template-for-auto-scaling,Version=1" --min-size 1 --max-size 3 --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" + +This example uses the default version of the specified launch template. It specifies Availability Zones and subnets and enables the instance protection setting:: + + aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg --launch-template LaunchTemplateId=lt-0a4872e2c396d941c --min-size 1 --max-size 3 --desired-capacity 2 --availability-zones us-west-2a us-west-2b us-west-2c --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" --new-instances-protected-from-scale-in + +This example creates an Auto Scaling group that launches a single instance using a launch template to optionally specify the ID of an existing network interface (ENI ID) to use. It specifies an Availability Zone that matches the specified network interface:: + + aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg-single-instance --launch-template "LaunchTemplateName=my-single-instance-asg-template,Version=2" --min-size 1 --max-size 1 --availability-zones us-west-2a + +This example creates an Auto Scaling group with a lifecycle hook that supports a custom action at instance termination:: + + aws autoscaling create-auto-scaling-group --cli-input-json file://~/config.json + +Contents of config.json file:: + + { + "AutoScalingGroupName": "my-asg", + "LaunchTemplate": { + "LaunchTemplateId": "lt-0a4872e2c396d941c" + }, + "LifecycleHookSpecificationList": [{ + "LifecycleHookName": "my-hook", + "LifecycleTransition": "autoscaling:EC2_INSTANCE_TERMINATING", + "NotificationTargetARN": "arn:aws:sqs:us-west-2:123456789012:my-sqs-queue", + "RoleARN": "arn:aws:iam::123456789012:role/my-notification-role", + "HeartbeatTimeout": 300, + "DefaultResult": "CONTINUE" + }], + "MinSize": 1, + "MaxSize": 5, + "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782", + "Tags": [{ + "ResourceType": "auto-scaling-group", + "ResourceId": "my-asg", + "PropagateAtLaunch": true, + "Value": "test", + "Key": "environment" + }] + } + +For more information, see the `Amazon EC2 Auto Scaling User Guide`_. + +.. _`Amazon EC2 Auto Scaling User Guide`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html diff --git a/bin/awscli/examples/autoscaling/create-launch-configuration.rst b/bin/awscli/examples/autoscaling/create-launch-configuration.rst index 89283e81..d500add2 100644 --- a/bin/awscli/examples/autoscaling/create-launch-configuration.rst +++ b/bin/awscli/examples/autoscaling/create-launch-configuration.rst @@ -4,10 +4,6 @@ This example creates a launch configuration:: aws autoscaling create-launch-configuration --launch-configuration-name my-launch-config --image-id ami-c6169af6 --instance-type m1.medium -This example creates a launch configuration that uses Spot Instances:: - - aws autoscaling create-launch-configuration --launch-configuration-name my-launch-config --image-id ami-c6169af6 --instance-type m1.medium --spot-price "0.50" - This example creates a launch configuration with a key pair and a bootstrapping script:: aws autoscaling create-launch-configuration --launch-configuration-name my-launch-config --key-name my-key-pair --image-id ami-c6169af6 --instance-type m1.small --user-data file://myuserdata.txt @@ -33,3 +29,15 @@ Add the following parameter to omit a device included on the instance (for examp Parameter:: --block-device-mappings "[{\"DeviceName\": \"/dev/sdf\",\"NoDevice\":\"\"}]" + +For more information about quoting JSON-formatted parameters, see `Quoting Strings`_ in the *AWS Command Line Interface User Guide*. + +This example creates a launch configuration that uses Spot Instances:: + + aws autoscaling create-launch-configuration --launch-configuration-name my-launch-config --image-id ami-01e24be29428c15b2 --instance-type c5.large --spot-price "0.50" + +For more information, see `Launching Spot Instances in Your Auto Scaling Group`_ in the *Amazon EC2 Auto Scaling User Guide*. + +.. _`Quoting Strings`: https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html#quoting-strings + +.. _`Launching Spot Instances in Your Auto Scaling Group`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-spot-instances.html diff --git a/bin/awscli/examples/autoscaling/delete-auto-scaling-group.rst b/bin/awscli/examples/autoscaling/delete-auto-scaling-group.rst index ff5bb1c7..63f87636 100644 --- a/bin/awscli/examples/autoscaling/delete-auto-scaling-group.rst +++ b/bin/awscli/examples/autoscaling/delete-auto-scaling-group.rst @@ -8,6 +8,6 @@ To delete the Auto Scaling group without waiting for the instances in the group aws autoscaling delete-auto-scaling-group --auto-scaling-group-name my-auto-scaling-group --force-delete -For more information, see `Shut Down Auto Scaling Processes`_ in the *Auto Scaling Developer Guide*. +For more information, see `Deleting Your Auto Scaling Infrastructure`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Shut Down Auto Scaling Processes`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-process-shutdown.html +.. _`Deleting Your Auto Scaling Infrastructure`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-process-shutdown.html diff --git a/bin/awscli/examples/autoscaling/delete-launch-configuration.rst b/bin/awscli/examples/autoscaling/delete-launch-configuration.rst index 0f6b7729..4b9b3629 100644 --- a/bin/awscli/examples/autoscaling/delete-launch-configuration.rst +++ b/bin/awscli/examples/autoscaling/delete-launch-configuration.rst @@ -4,6 +4,6 @@ This example deletes the specified launch configuration:: aws autoscaling delete-launch-configuration --launch-configuration-name my-launch-config -For more information, see `Shut Down Auto Scaling Processes`_ in the *Auto Scaling Developer Guide*. +For more information, see `Deleting Your Auto Scaling Infrastructure`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Shut Down Auto Scaling Processes`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-process-shutdown.html +.. _`Deleting Your Auto Scaling Infrastructure`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-process-shutdown.html diff --git a/bin/awscli/examples/autoscaling/delete-notification-configuration.rst b/bin/awscli/examples/autoscaling/delete-notification-configuration.rst index a7993efa..0a7023f9 100644 --- a/bin/awscli/examples/autoscaling/delete-notification-configuration.rst +++ b/bin/awscli/examples/autoscaling/delete-notification-configuration.rst @@ -4,6 +4,6 @@ This example deletes the specified notification from the specified Auto Scaling aws autoscaling delete-notification-configuration --auto-scaling-group-name my-auto-scaling-group --topic-arn arn:aws:sns:us-west-2:123456789012:my-sns-topic -For more information, see `Delete the Notification Configuration`_ in the *Auto Scaling Developer Guide*. +For more information, see `Delete the Notification Configuration`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Delete the Notification Configuration`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/ASGettingNotifications.html#delete-settingupnotifications +.. _`Delete the Notification Configuration`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ASGettingNotifications.html#delete-settingupnotifications diff --git a/bin/awscli/examples/autoscaling/delete-tags.rst b/bin/awscli/examples/autoscaling/delete-tags.rst index 37668d52..33492557 100644 --- a/bin/awscli/examples/autoscaling/delete-tags.rst +++ b/bin/awscli/examples/autoscaling/delete-tags.rst @@ -4,6 +4,6 @@ This example deletes the specified tag from the specified Auto Scaling group:: aws autoscaling delete-tags --tags ResourceId=my-auto-scaling-group,ResourceType=auto-scaling-group,Key=Dept,Value=Research -For more information, see `Tagging Auto Scaling Groups and Instances`_ in the *Auto Scaling Developer Guide*. +For more information, see `Tagging Auto Scaling Groups and Instances`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Tagging Auto Scaling Groups and Instances`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/ASTagging.html +.. _`Tagging Auto Scaling Groups and Instances`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html diff --git a/bin/awscli/examples/autoscaling/describe-account-limits.rst b/bin/awscli/examples/autoscaling/describe-account-limits.rst index 26758568..5db97d33 100644 --- a/bin/awscli/examples/autoscaling/describe-account-limits.rst +++ b/bin/awscli/examples/autoscaling/describe-account-limits.rst @@ -13,6 +13,6 @@ The following is example output:: "MaxNumberOfAutoScalingGroups": 20 } -For more information, see `Auto Scaling Limits`_ in the *Auto Scaling Developer Guide*. +For more information, see `Amazon EC2 Auto Scaling Limits`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Auto Scaling Limits`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-account-limits.html +.. _`Amazon EC2 Auto Scaling Limits`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html diff --git a/bin/awscli/examples/autoscaling/describe-adjustment-types.rst b/bin/awscli/examples/autoscaling/describe-adjustment-types.rst index d3bf4ded..9ee213da 100644 --- a/bin/awscli/examples/autoscaling/describe-adjustment-types.rst +++ b/bin/awscli/examples/autoscaling/describe-adjustment-types.rst @@ -20,6 +20,6 @@ The following is example output:: ] } -For more information, see `Scaling Adjustment Types`_ in the *Auto Scaling Developer Guide*. +For more information, see `Scaling Adjustment Types`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Scaling Adjustment Types`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-scale-based-on-demand.html#as-scaling-adjustment +.. _`Scaling Adjustment Types`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html#as-scaling-adjustment diff --git a/bin/awscli/examples/autoscaling/describe-auto-scaling-groups.rst b/bin/awscli/examples/autoscaling/describe-auto-scaling-groups.rst index fbcc6728..c311ff72 100644 --- a/bin/awscli/examples/autoscaling/describe-auto-scaling-groups.rst +++ b/bin/awscli/examples/autoscaling/describe-auto-scaling-groups.rst @@ -4,6 +4,14 @@ This example describes the specified Auto Scaling group:: aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name my-auto-scaling-group +This example describes the specified Auto Scaling groups. It allows you to specify up to 100 group names:: + + aws autoscaling describe-auto-scaling-groups --max-items 100 --auto-scaling-group-name "group1" "group2" "group3" "group4" + +This example describes the Auto Scaling groups in the specified region, up to a maximum of 75 groups:: + + aws autoscaling describe-auto-scaling-groups --max-items 75 --region us-east-1 + The following is example output:: { diff --git a/bin/awscli/examples/autoscaling/describe-auto-scaling-notification-types.rst b/bin/awscli/examples/autoscaling/describe-auto-scaling-notification-types.rst index a66b076c..c0830bb7 100644 --- a/bin/awscli/examples/autoscaling/describe-auto-scaling-notification-types.rst +++ b/bin/awscli/examples/autoscaling/describe-auto-scaling-notification-types.rst @@ -16,6 +16,6 @@ The following is example output:: ] } -For more information, see `Configure Your Auto Scaling Group to Send Notifications`_ in the *Auto Scaling Developer Guide*. +For more information, see `Getting Amazon SNS Notifications When Your Auto Scaling Group Scales`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Configure Your Auto Scaling Group to Send Notifications`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/ASGettingNotifications.html#as-configure-asg-for-sns +.. _`Getting Amazon SNS Notifications When Your Auto Scaling Group Scales`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ASGettingNotifications.html diff --git a/bin/awscli/examples/autoscaling/describe-metric-collection-types.rst b/bin/awscli/examples/autoscaling/describe-metric-collection-types.rst index a1566492..2ef5cacf 100644 --- a/bin/awscli/examples/autoscaling/describe-metric-collection-types.rst +++ b/bin/awscli/examples/autoscaling/describe-metric-collection-types.rst @@ -40,6 +40,6 @@ The following is example output:: ] } -For more information, see `Enable Auto Scaling Group Metrics`_ in the *Auto Scaling Developer Guide*. +For more information, see `Auto Scaling Group Metrics`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Enable Auto Scaling Group Metrics`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-instance-monitoring.html#as-group-metrics +.. _`Auto Scaling Group Metrics`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-monitoring.html#as-group-metrics diff --git a/bin/awscli/examples/autoscaling/describe-notification-configurations.rst b/bin/awscli/examples/autoscaling/describe-notification-configurations.rst index 9b131b76..c1436859 100644 --- a/bin/awscli/examples/autoscaling/describe-notification-configurations.rst +++ b/bin/awscli/examples/autoscaling/describe-notification-configurations.rst @@ -42,6 +42,6 @@ Use the ``NextToken`` field with the ``starting-token`` parameter in a subsequen aws autoscaling describe-notification-configurations --auto-scaling-group-name my-auto-scaling-group --starting-token Z3M3LMPEXAMPLE -For more information, see `Getting Notifications When Your Auto Scaling Group Changes`_ in the *Auto Scaling Developer Guide*. +For more information, see `Getting Amazon SNS Notifications When Your Auto Scaling Group Scales`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Getting Notifications When Your Auto Scaling Group Changes`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/ASGettingNotifications.html +.. _`Getting Amazon SNS Notifications When Your Auto Scaling Group Scales`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ASGettingNotifications.html diff --git a/bin/awscli/examples/autoscaling/describe-policies.rst b/bin/awscli/examples/autoscaling/describe-policies.rst index 4355d09f..3ae2e316 100644 --- a/bin/awscli/examples/autoscaling/describe-policies.rst +++ b/bin/awscli/examples/autoscaling/describe-policies.rst @@ -57,6 +57,6 @@ If the output includes a ``NextToken`` field, use the value of this field with t aws autoscaling describe-policies --auto-scaling-group-name my-auto-scaling-group --starting-token Z3M3LMPEXAMPLE -For more information, see `Dynamic Scaling`_ in the *Auto Scaling Developer Guide*. +For more information, see `Dynamic Scaling`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Dynamic Scaling`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-scale-based-on-demand.html +.. _`Dynamic Scaling`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scale-based-on-demand.html diff --git a/bin/awscli/examples/autoscaling/describe-scaling-process-types.rst b/bin/awscli/examples/autoscaling/describe-scaling-process-types.rst index 8b590cd2..7e4b9b2f 100644 --- a/bin/awscli/examples/autoscaling/describe-scaling-process-types.rst +++ b/bin/awscli/examples/autoscaling/describe-scaling-process-types.rst @@ -35,6 +35,6 @@ The following is example output:: ] } -For more information, see `Suspend and Resume Auto Scaling Processes`_ in the *Auto Scaling Developer Guide*. +For more information, see `Suspending and Resuming Scaling Processes`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Suspend and Resume Auto Scaling Processes`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/US_SuspendResume.html +.. _`Suspending and Resuming Scaling Processes`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-suspend-resume-processes.html diff --git a/bin/awscli/examples/autoscaling/describe-scheduled-actions.rst b/bin/awscli/examples/autoscaling/describe-scheduled-actions.rst index a9f3eb4d..e26b4cca 100644 --- a/bin/awscli/examples/autoscaling/describe-scheduled-actions.rst +++ b/bin/awscli/examples/autoscaling/describe-scheduled-actions.rst @@ -13,7 +13,7 @@ The following is example output:: "DesiredCapacity": 4, "AutoScalingGroupName": "my-auto-scaling-group", "MaxSize": 6, - "Recurrence": "30 0 1 12 0", + "Recurrence": "30 0 1 12 *", "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": "2019-12-01T00:30:00Z", @@ -52,7 +52,7 @@ The following is example output:: "DesiredCapacity": 4, "AutoScalingGroupName": "my-auto-scaling-group", "MaxSize": 6, - "Recurrence": "30 0 1 12 0", + "Recurrence": "30 0 1 12 *", "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": "2019-12-01T00:30:00Z", @@ -65,6 +65,6 @@ Use the ``NextToken`` field with the ``starting-token`` parameter in a subsequen aws autoscaling describe-scheduled-actions --auto-scaling-group-name my-auto-scaling-group --starting-token Z3M3LMPEXAMPLE -For more information, see `Scheduled Scaling`_ in the *Auto Scaling Developer Guide*. +For more information, see `Scheduled Scaling`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Scheduled Scaling`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/schedule_time.html +.. _`Scheduled Scaling`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/schedule_time.html diff --git a/bin/awscli/examples/autoscaling/describe-tags.rst b/bin/awscli/examples/autoscaling/describe-tags.rst index 78b29821..041d8bbe 100644 --- a/bin/awscli/examples/autoscaling/describe-tags.rst +++ b/bin/awscli/examples/autoscaling/describe-tags.rst @@ -52,6 +52,6 @@ Use the ``NextToken`` field with the ``starting-token`` parameter in a subsequen aws autoscaling describe-tags --filters Name=auto-scaling-group,Values=my-auto-scaling-group --starting-token Z3M3LMPEXAMPLE -For more information, see `Tagging Auto Scaling Groups and Instances`_ in the *Auto Scaling Developer Guide*. +For more information, see `Tagging Auto Scaling Groups and Instances`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Tagging Auto Scaling Groups and Instances`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/ASTagging.html +.. _`Tagging Auto Scaling Groups and Instances`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html diff --git a/bin/awscli/examples/autoscaling/describe-termination-policy-types.rst b/bin/awscli/examples/autoscaling/describe-termination-policy-types.rst index 8bf81677..aa076109 100644 --- a/bin/awscli/examples/autoscaling/describe-termination-policy-types.rst +++ b/bin/awscli/examples/autoscaling/describe-termination-policy-types.rst @@ -8,14 +8,16 @@ The following is example output:: { "TerminationPolicyTypes": [ + "AllocationStrategy", "ClosestToNextInstanceHour", "Default", "NewestInstance", "OldestInstance", - "OldestLaunchConfiguration" + "OldestLaunchConfiguration", + "OldestLaunchTemplate" ] } -For more information, see `Controlling Which Instances Auto Scaling Terminates During Scale In`_ in the *Auto Scaling Developer Guide*. +For more information, see `Controlling Which Instances Auto Scaling Terminates During Scale In`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Controlling Which Instances Auto Scaling Terminates During Scale In`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/AutoScalingBehavior.InstanceTermination.html#your-termination-policy +.. _`Controlling Which Instances Auto Scaling Terminates During Scale In`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html diff --git a/bin/awscli/examples/autoscaling/disable-metrics-collection.rst b/bin/awscli/examples/autoscaling/disable-metrics-collection.rst index 298ff273..a6a9cc69 100644 --- a/bin/awscli/examples/autoscaling/disable-metrics-collection.rst +++ b/bin/awscli/examples/autoscaling/disable-metrics-collection.rst @@ -4,6 +4,6 @@ This example disables collecting data for the ``GroupDesiredCapacity`` metric fo aws autoscaling disable-metrics-collection --auto-scaling-group-name my-auto-scaling-group --metrics GroupDesiredCapacity -For more information, see `Monitoring Your Auto Scaling Instances and Groups`_ in the *Auto Scaling Developer Guide*. +For more information, see `Monitoring Your Auto Scaling Groups and Instances Using Amazon CloudWatch`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Monitoring Your Auto Scaling Instances and Groups`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-instance-monitoring.html +.. _`Monitoring Your Auto Scaling Groups and Instances Using Amazon CloudWatch`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-monitoring.html diff --git a/bin/awscli/examples/autoscaling/enable-metrics-collection.rst b/bin/awscli/examples/autoscaling/enable-metrics-collection.rst index cf1309c7..3b0d6b96 100644 --- a/bin/awscli/examples/autoscaling/enable-metrics-collection.rst +++ b/bin/awscli/examples/autoscaling/enable-metrics-collection.rst @@ -8,6 +8,6 @@ To collect data for a specific metric, use the ``metrics`` parameter:: aws autoscaling enable-metrics-collection --auto-scaling-group-name my-auto-scaling-group --metrics GroupDesiredCapacity --granularity "1Minute" -For more information, see `Monitoring Your Auto Scaling Instances and Groups`_ in the *Auto Scaling Developer Guide*. +For more information, see `Monitoring Your Auto Scaling Groups and Instances Using Amazon CloudWatch`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Monitoring Your Auto Scaling Instances and Groups`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-instance-monitoring.html +.. _`Monitoring Your Auto Scaling Groups and Instances Using Amazon CloudWatch`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-monitoring.html diff --git a/bin/awscli/examples/autoscaling/execute-policy.rst b/bin/awscli/examples/autoscaling/execute-policy.rst index 479e799b..a9d7d9c0 100644 --- a/bin/awscli/examples/autoscaling/execute-policy.rst +++ b/bin/awscli/examples/autoscaling/execute-policy.rst @@ -4,6 +4,6 @@ This example executes the specified Auto Scaling policy for the specified Auto S aws autoscaling execute-policy --auto-scaling-group-name my-auto-scaling-group --policy-name ScaleIn --honor-cooldown -For more information, see `Dynamic Scaling`_ in the *Auto Scaling Developer Guide*. +For more information, see `Dynamic Scaling`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Dynamic Scaling`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-scale-based-on-demand.html +.. _`Dynamic Scaling`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scale-based-on-demand.html diff --git a/bin/awscli/examples/autoscaling/put-lifecycle-hook.rst b/bin/awscli/examples/autoscaling/put-lifecycle-hook.rst index 9d7dcb92..8f4e5efa 100644 --- a/bin/awscli/examples/autoscaling/put-lifecycle-hook.rst +++ b/bin/awscli/examples/autoscaling/put-lifecycle-hook.rst @@ -4,6 +4,6 @@ This example creates a lifecycle hook:: aws autoscaling put-lifecycle-hook --lifecycle-hook-name my-lifecycle-hook --auto-scaling-group-name my-auto-scaling-group --lifecycle-transition autoscaling:EC2_INSTANCE_LAUNCHING --notification-target-arn arn:aws:sns:us-west-2:123456789012:my-sns-topic --role-arn arn:aws:iam::123456789012:role/my-auto-scaling-role -For more information, see `Adding Lifecycle Hooks`_ in the *Auto Scaling Developer Guide*. +For more information, see `Add Lifecycle Hooks`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Adding Lifecycle Hooks`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/adding-lifecycle-hooks.html +.. _`Add Lifecycle Hooks`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html#adding-lifecycle-hooks diff --git a/bin/awscli/examples/autoscaling/put-notification-configuration.rst b/bin/awscli/examples/autoscaling/put-notification-configuration.rst index 1c50d5b2..bd800a2b 100644 --- a/bin/awscli/examples/autoscaling/put-notification-configuration.rst +++ b/bin/awscli/examples/autoscaling/put-notification-configuration.rst @@ -4,6 +4,6 @@ This example adds the specified notification to the specified Auto Scaling group aws autoscaling put-notification-configuration --auto-scaling-group-name my-auto-scaling-group --topic-arn arn:aws:sns:us-west-2:123456789012:my-sns-topic --notification-type autoscaling:TEST_NOTIFICATION -For more information, see `Configure Your Auto Scaling Group to Send Notifications`_ in the *Auto Scaling Developer Guide*. +For more information, see `Getting Amazon SNS Notifications When Your Auto Scaling Group Scales`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Configure Your Auto Scaling Group to Send Notifications`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/ASGettingNotifications.html#as-configure-asg-for-sns +.. _`Getting Amazon SNS Notifications When Your Auto Scaling Group Scales`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ASGettingNotifications.html#as-configure-asg-for-sns diff --git a/bin/awscli/examples/autoscaling/put-scaling-policy.rst b/bin/awscli/examples/autoscaling/put-scaling-policy.rst index 15bfed03..59fc5188 100644 --- a/bin/awscli/examples/autoscaling/put-scaling-policy.rst +++ b/bin/awscli/examples/autoscaling/put-scaling-policy.rst @@ -1,6 +1,6 @@ **To add a scaling policy to an Auto Scaling group** -This example adds the specified policy to the specified Auto Scaling group:: +This example adds a simple scaling policy to the specified Auto Scaling group:: aws autoscaling put-scaling-policy --auto-scaling-group-name my-auto-scaling-group --policy-name ScaleIn --scaling-adjustment -1 --adjustment-type ChangeInCapacity @@ -15,6 +15,6 @@ The output includes the ARN of the policy. The following is example output:: "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2233f3d7-6290-403b-b632-93c553560106:autoScalingGroupName/my-auto-scaling-group:policyName/ScaleIn" } -For more information, see `Dynamic Scaling`_ in the *Auto Scaling Developer Guide*. +For more information, see `Dynamic Scaling`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Dynamic Scaling`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-scale-based-on-demand.html +.. _`Dynamic Scaling`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scale-based-on-demand.html diff --git a/bin/awscli/examples/autoscaling/put-scheduled-update-group-action.rst b/bin/awscli/examples/autoscaling/put-scheduled-update-group-action.rst index df0421c4..dc2239c0 100644 --- a/bin/awscli/examples/autoscaling/put-scheduled-update-group-action.rst +++ b/bin/awscli/examples/autoscaling/put-scheduled-update-group-action.rst @@ -6,8 +6,8 @@ This example adds the specified scheduled action to the specified Auto Scaling g This example creates a scheduled action to scale on a recurring schedule that is scheduled to execute at 00:30 hours on the first of January, June, and December every year:: - aws autoscaling put-scheduled-update-group-action --auto-scaling-group-name my-auto-scaling-group --scheduled-action-name my-scheduled-action --recurrence "30 0 1 1,6,12 0" --min-size 2 --max-size 6 --desired-capacity 4 + aws autoscaling put-scheduled-update-group-action --auto-scaling-group-name my-auto-scaling-group --scheduled-action-name my-scheduled-action --recurrence "30 0 1 1,6,12 *" --min-size 2 --max-size 6 --desired-capacity 4 -For more information, see `Scheduled Scaling`__ in the *Auto Scaling Developer Guide*. +For more information, see `Scheduled Scaling`__ in the *Amazon EC2 Auto Scaling User Guide*. -.. __: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/schedule_time.html +.. __: https://docs.aws.amazon.com/autoscaling/ec2/userguide/schedule_time.html \ No newline at end of file diff --git a/bin/awscli/examples/autoscaling/resume-processes.rst b/bin/awscli/examples/autoscaling/resume-processes.rst index 4c5bdf59..b615c473 100644 --- a/bin/awscli/examples/autoscaling/resume-processes.rst +++ b/bin/awscli/examples/autoscaling/resume-processes.rst @@ -4,6 +4,6 @@ This example resumes the specified suspended scaling process for the specified A aws autoscaling resume-processes --auto-scaling-group-name my-auto-scaling-group --scaling-processes AlarmNotification -For more information, see `Suspend and Resume Auto Scaling Processes`_ in the *Auto Scaling Developer Guide*. +For more information, see `Suspending and Resuming Scaling Processes`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Suspend and Resume Auto Scaling Processes`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/US_SuspendResume.html +.. _`Suspending and Resuming Scaling Processes`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-suspend-resume-processes.html diff --git a/bin/awscli/examples/autoscaling/suspend-processes.rst b/bin/awscli/examples/autoscaling/suspend-processes.rst index 750fd089..e5ac07e5 100644 --- a/bin/awscli/examples/autoscaling/suspend-processes.rst +++ b/bin/awscli/examples/autoscaling/suspend-processes.rst @@ -4,6 +4,6 @@ This example suspends the specified scaling process for the specified Auto Scali aws autoscaling suspend-processes --auto-scaling-group-name my-auto-scaling-group --scaling-processes AlarmNotification -For more information, see `Suspend and Resume Auto Scaling Processes`_ in the *Auto Scaling Developer Guide*. +For more information, see `Suspending and Resuming Scaling Processes`_ in the *Amazon EC2 Auto Scaling User Guide*. -.. _`Suspend and Resume Auto Scaling Processes`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/US_SuspendResume.html +.. _`Suspending and Resuming Scaling Processes`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-suspend-resume-processes.html diff --git a/bin/awscli/examples/budgets/create-budget.rst b/bin/awscli/examples/budgets/create-budget.rst new file mode 100644 index 00000000..e3dd4033 --- /dev/null +++ b/bin/awscli/examples/budgets/create-budget.rst @@ -0,0 +1,57 @@ +**To create a Cost and Usage budget** + +This example creates a Cost and Usage budget. + +Command:: + + aws budgets create-budget --account-id 111122223333 --budget file://budget.json --notifications-with-subscribers file://notifications-with-subscribers.json + +budget.json:: + + { + "BudgetLimit": { + "Amount": "100", + "Unit": "USD" + }, + "BudgetName": "Example Budget", + "BudgetType": "COST", + "CostFilters": { + "AZ" : [ "us-east-1" ] + }, + "CostTypes": { + "IncludeCredit": true, + "IncludeDiscount": true, + "IncludeOtherSubscription": true, + "IncludeRecurring": true, + "IncludeRefund": true, + "IncludeSubscription": true, + "IncludeSupport": true, + "IncludeTax": true, + "IncludeUpfront": true, + "UseBlended": false + }, + "TimePeriod": { + "Start": 1477958399, + "End": 3706473600 + }, + "TimeUnit": "MONTHLY" + } + +notifications-with-subscribers.json:: + + [ + { + "Notification": { + "ComparisonOperator": "GREATER_THAN", + "NotificationType": "ACTUAL", + "Threshold": 80, + "ThresholdType": "PERCENTAGE" + }, + "Subscribers": [ + { + "Address": "example@example.com", + "SubscriptionType": "EMAIL" + } + ] + } + ] diff --git a/bin/awscli/examples/budgets/create-notification.rst b/bin/awscli/examples/budgets/create-notification.rst new file mode 100644 index 00000000..2a52dbc1 --- /dev/null +++ b/bin/awscli/examples/budgets/create-notification.rst @@ -0,0 +1,8 @@ +**To create a notification for the specified Cost and Usage budget** + +This example creates a notification for the specified Cost and Usage budget. + +Command:: + + aws budgets create-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com + diff --git a/bin/awscli/examples/budgets/create-subscriber.rst b/bin/awscli/examples/budgets/create-subscriber.rst new file mode 100644 index 00000000..7a55c124 --- /dev/null +++ b/bin/awscli/examples/budgets/create-subscriber.rst @@ -0,0 +1,8 @@ +**To create a subscriber for a notification associated with a Cost and Usage budget** + +This example creates a subscriber for the specified notification. + +Command:: + + aws budgets create-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com + diff --git a/bin/awscli/examples/budgets/delete-budget.rst b/bin/awscli/examples/budgets/delete-budget.rst new file mode 100644 index 00000000..4de98d60 --- /dev/null +++ b/bin/awscli/examples/budgets/delete-budget.rst @@ -0,0 +1,8 @@ +**To delete a Cost and Usage budget** + +This example deletes the specified Cost and Usage budget. + +Command:: + + aws budgets delete-budget --account-id 111122223333 --budget-name "Example Budget" + diff --git a/bin/awscli/examples/budgets/delete-notification.rst b/bin/awscli/examples/budgets/delete-notification.rst new file mode 100644 index 00000000..4089214c --- /dev/null +++ b/bin/awscli/examples/budgets/delete-notification.rst @@ -0,0 +1,8 @@ +**To delete a notification from a budget** + +This example deletes the specified notification from the specified budget. + +Command:: + + aws budgets delete-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE + diff --git a/bin/awscli/examples/budgets/delete-subscriber.rst b/bin/awscli/examples/budgets/delete-subscriber.rst new file mode 100644 index 00000000..0c5f716b --- /dev/null +++ b/bin/awscli/examples/budgets/delete-subscriber.rst @@ -0,0 +1,8 @@ +**To delete a subscriber from a notification** + +This example deletes the specified subscriber from the specified notification. + +Command:: + + aws budgets delete-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com + diff --git a/bin/awscli/examples/budgets/describe-budget.rst b/bin/awscli/examples/budgets/describe-budget.rst new file mode 100644 index 00000000..28d8cac9 --- /dev/null +++ b/bin/awscli/examples/budgets/describe-budget.rst @@ -0,0 +1,54 @@ +**To retrieve a budget associated with an account** + +This example retrieves the specified Cost and Usage budget. + +Command:: + + aws budgets describe-budget --account-id 111122223333 --budget-name "Example Budget" + +Output:: + + { + "Budget": { + "CalculatedSpend": { + "ForecastedSpend": { + "Amount": "2641.54800000000022919266484677791595458984375", + "Unit": "USD" + }, + "ActualSpend": { + "Amount": "604.4560000000000172803993336856365203857421875", + "Unit": "USD" + } + }, + "BudgetType": "COST", + "BudgetLimit": { + "Amount": "100", + "Unit": "USD" + }, + "BudgetName": "Example Budget", + "CostTypes": { + "IncludeOtherSubscription": true, + "IncludeUpfront": true, + "IncludeRefund": true, + "UseBlended": false, + "IncludeDiscount": true, + "UseAmortized": false, + "IncludeTax": true, + "IncludeCredit": true, + "IncludeSupport": true, + "IncludeRecurring": true, + "IncludeSubscription": true + }, + "TimeUnit": "MONTHLY", + "TimePeriod": { + "Start": 1477958399.0, + "End": 3706473600.0 + }, + "CostFilters": { + "AZ": [ + "us-east-1" + ] + } + } + } + diff --git a/bin/awscli/examples/budgets/describe-budgets.rst b/bin/awscli/examples/budgets/describe-budgets.rst new file mode 100644 index 00000000..8035fa60 --- /dev/null +++ b/bin/awscli/examples/budgets/describe-budgets.rst @@ -0,0 +1,58 @@ + + +**To retrieve the budgets associated with an account** + +This example retrieves the Cost and Usage budgets for an account. + +Command:: + + aws budgets describe-budgets --account-id 111122223333 --max-results 20 + +Output:: + + { + "Budgets": [ + { + "CalculatedSpend": { + "ForecastedSpend": { + "Amount": "2641.54800000000022919266484677791595458984375", + "Unit": "USD" + }, + "ActualSpend": { + "Amount": "604.4560000000000172803993336856365203857421875", + "Unit": "USD" + } + }, + "BudgetType": "COST", + "BudgetLimit": { + "Amount": "100", + "Unit": "USD" + }, + "BudgetName": "Example Budget", + "CostTypes": { + "IncludeOtherSubscription": true, + "IncludeUpfront": true, + "IncludeRefund": true, + "UseBlended": false, + "IncludeDiscount": true, + "UseAmortized": false, + "IncludeTax": true, + "IncludeCredit": true, + "IncludeSupport": true, + "IncludeRecurring": true, + "IncludeSubscription": true + }, + "TimeUnit": "MONTHLY", + "TimePeriod": { + "Start": 1477958399.0, + "End": 3706473600.0 + }, + "CostFilters": { + "AZ": [ + "us-east-1" + ] + } + } + ] + } + diff --git a/bin/awscli/examples/budgets/describe-notifications-for-budget.rst b/bin/awscli/examples/budgets/describe-notifications-for-budget.rst new file mode 100644 index 00000000..04ba9684 --- /dev/null +++ b/bin/awscli/examples/budgets/describe-notifications-for-budget.rst @@ -0,0 +1,19 @@ +**To retrieve the notifications for a budget** + +This example retrieves the notifications for a Cost and Usage budget. + +Command:: + + aws budgets describe-notifications-for-budget --account-id 111122223333 --budget-name "Example Budget" --max-results 5 + +Output:: + + { + "Notifications": [ + { + "Threshold": 80.0, + "ComparisonOperator": "GREATER_THAN", + "NotificationType": "ACTUAL" + } + ] + } diff --git a/bin/awscli/examples/budgets/describe-subscribers-for-notification.rst b/bin/awscli/examples/budgets/describe-subscribers-for-notification.rst new file mode 100644 index 00000000..9146fd9f --- /dev/null +++ b/bin/awscli/examples/budgets/describe-subscribers-for-notification.rst @@ -0,0 +1,22 @@ +**To retrieve the subscribers for a budget notification** + +This example retrieves the subscribers for a Cost and Usage budget notification. + +Command:: + + aws budgets describe-subscribers-for-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --max-results 5 + +Output:: + + { + "Subscribers": [ + { + "SubscriptionType": "EMAIL", + "Address": "example2@example.com" + }, + { + "SubscriptionType": "EMAIL", + "Address": "example@example.com" + } + ] + } diff --git a/bin/awscli/examples/budgets/update-budget.rst b/bin/awscli/examples/budgets/update-budget.rst new file mode 100644 index 00000000..11924c5b --- /dev/null +++ b/bin/awscli/examples/budgets/update-budget.rst @@ -0,0 +1,40 @@ +**To replace a budget for a Cost and Usage budget** + +This example replaces a Cost and Usage budget with a new budget. + +Command:: + + aws budgets update-budget --account-id 111122223333 --new-budget file://new-budget.json + +new-budget.json:: + + { + "BudgetLimit": { + "Amount": "100", + "Unit": "USD" + }, + "BudgetName": "Example Budget", + "BudgetType": "COST", + "CostFilters": { + "AZ" : [ "us-east-1" ] + }, + "CostTypes": { + "IncludeCredit": false, + "IncludeDiscount": true, + "IncludeOtherSubscription": true, + "IncludeRecurring": true, + "IncludeRefund": true, + "IncludeSubscription": true, + "IncludeSupport": true, + "IncludeTax": true, + "IncludeUpfront": true, + "UseBlended": false, + "UseAmortized": true + }, + "TimePeriod": { + "Start": 1477958399, + "End": 3706473600 + }, + "TimeUnit": "MONTHLY" + } + diff --git a/bin/awscli/examples/budgets/update-notification.rst b/bin/awscli/examples/budgets/update-notification.rst new file mode 100644 index 00000000..8078f01c --- /dev/null +++ b/bin/awscli/examples/budgets/update-notification.rst @@ -0,0 +1,8 @@ +**To replace a notification for a Cost and Usage budget** + +This example replaces an 80% notification for a Cost and Usage budget with a 90% notification. + +Command:: + + aws budgets update-notification --account-id 111122223333 --budget-name "Example Budget" --old-notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --new-notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=90,ThresholdType=PERCENTAGE + diff --git a/bin/awscli/examples/budgets/update-subscriber.rst b/bin/awscli/examples/budgets/update-subscriber.rst new file mode 100644 index 00000000..a15b344d --- /dev/null +++ b/bin/awscli/examples/budgets/update-subscriber.rst @@ -0,0 +1,7 @@ +**To replace a subscriber for a Cost and Usage budget** + +This example replaces the subscriber for a Cost and Usage budget. + +Command:: + + aws budgets update-subscriber --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --old-subscriber SubscriptionType=EMAIL,Address=example@example.com --new-subscriber SubscriptionType=EMAIL,Address=example2@example.com diff --git a/bin/awscli/examples/ce/get-cost-and-usage.rst b/bin/awscli/examples/ce/get-cost-and-usage.rst new file mode 100644 index 00000000..6e8c1565 --- /dev/null +++ b/bin/awscli/examples/ce/get-cost-and-usage.rst @@ -0,0 +1,88 @@ +**To retrieve the S3 usage of an account for the month of September 2017** + +The following ``get-cost-and-usage`` example retrieves the S3 usage of an account for the month of September 2017. :: + + aws ce get-cost-and-usage \ + --time-period Start=2017-09-01,End=2017-10-01 \ + --granularity MONTHLY \ + --metrics "BlendedCost" "UnblendedCost" "UsageQuantity" \ + --group-by Type=DIMENSION,Key=SERVICE Type=TAG,Key=Environment \ + --filter file://filters.json + +Contents of ``filters.json``:: + + { + "Dimensions": { + "Key": "SERVICE", + "Values": [ + "Amazon Simple Storage Service" + ] + } + } + +Output:: + + { + "GroupDefinitions": [ + { + "Type": "DIMENSION", + "Key": "SERVICE" + }, + { + "Type": "TAG", + "Key": "Environment" + } + ], + "ResultsByTime": [ + { + "Estimated": false, + "TimePeriod": { + "Start": "2017-09-01", + "End": "2017-10-01" + }, + "Total": {}, + "Groups": [ + { + "Keys": [ + "Amazon Simple Storage Service", + "Environment$" + ], + "Metrics": { + "BlendedCost": { + "Amount": "40.3527508453", + "Unit": "USD" + }, + "UnblendedCost": { + "Amount": "40.3543773134", + "Unit": "USD" + }, + "UsageQuantity": { + "Amount": "9312771.098461578", + "Unit": "N/A" + } + } + }, + { + "Keys": [ + "Amazon Simple Storage Service", + "Environment$Dev" + ], + "Metrics": { + "BlendedCost": { + "Amount": "0.2682364644", + "Unit": "USD" + }, + "UnblendedCost": { + "Amount": "0.2682364644", + "Unit": "USD" + }, + "UsageQuantity": { + "Amount": "22403.4395271182", + "Unit": "N/A" + } + } + } + ] + } + ] + } diff --git a/bin/awscli/examples/ce/get-dimension-values.rst b/bin/awscli/examples/ce/get-dimension-values.rst new file mode 100644 index 00000000..b0f0369d --- /dev/null +++ b/bin/awscli/examples/ce/get-dimension-values.rst @@ -0,0 +1,41 @@ + +**To retrieve the tags for the dimension SERVICE, with a value of "Elastic"** + +This example retrieves the tags for the dimension SERVICE, with a value of "Elastic" for January 01 2017 through May 18 2017. + +Command:: + + aws ce get-dimension-values --search-string Elastic --time-period Start=2017-01-01,End=2017-05-18 --dimension SERVICE + +Output:: + + { + "TotalSize": 6, + "DimensionValues": [ + { + "Attributes": {}, + "Value": "Amazon ElastiCache" + }, + { + "Attributes": {}, + "Value": "EC2 - Other" + }, + { + "Attributes": {}, + "Value": "Amazon Elastic Compute Cloud - Compute" + }, + { + "Attributes": {}, + "Value": "Amazon Elastic Load Balancing" + }, + { + "Attributes": {}, + "Value": "Amazon Elastic MapReduce" + }, + { + "Attributes": {}, + "Value": "Amazon Elasticsearch Service" + } + ], + "ReturnSize": 6 + } diff --git a/bin/awscli/examples/ce/get-reservation-coverage.rst b/bin/awscli/examples/ce/get-reservation-coverage.rst new file mode 100644 index 00000000..6e6ab7a4 --- /dev/null +++ b/bin/awscli/examples/ce/get-reservation-coverage.rst @@ -0,0 +1,63 @@ + +**To retrieve the reservation coverage for EC2 t2.nano instances in the us-east-1 region** + +This example retrieves the reservation coverage for EC2 t2.nano instances in the us-east-1 region for July-September of 2017. + +Command:: + + aws ce get-reservation-coverage --time-period Start=2017-07-01,End=2017-10-01 --group-by Type=Dimension,Key=REGION --filter file://filters.json + +filters.json:: + + { + "And": [ + { + "Dimensions": { + "Key": "INSTANCE_TYPE", + "Values": [ + "t2.nano" + ] + }, + "Dimensions": { + "Key": "REGION", + "Values": [ + "us-east-1" + ] + } + } + ] + } + +Output:: + + { + "TotalSize": 6, + "DimensionValues": [ + { + "Attributes": {}, + "Value": "Amazon ElastiCache" + }, + { + "Attributes": {}, + "Value": "EC2 - Other" + }, + { + "Attributes": {}, + "Value": "Amazon Elastic Compute Cloud - Compute" + }, + { + "Attributes": {}, + "Value": "Amazon Elastic Load Balancing" + }, + { + "Attributes": {}, + "Value": "Amazon Elastic MapReduce" + }, + { + "Attributes": {}, + "Value": "Amazon Elasticsearch Service" + } + ], + "ReturnSize": 6 + } + diff --git a/bin/awscli/examples/ce/get-reservation-purchase-recommendation.rst b/bin/awscli/examples/ce/get-reservation-purchase-recommendation.rst new file mode 100644 index 00000000..b8f64034 --- /dev/null +++ b/bin/awscli/examples/ce/get-reservation-purchase-recommendation.rst @@ -0,0 +1,19 @@ +**To retrieve the reservation recommendations for Partial Upfront EC2 RIs with a three year term** + +The following ``get-reservation-purchase-recommendation`` example retrieves recommendations for Partial Upfront EC2 instances with a three-year term, based on the last 60 days of EC2 usage. :: + + aws ce get-reservation-purchase-recommendation \ + --service "Amazon Redshift" \ + --lookback-period-in-days SIXTY_DAYS \ + --term-in-years THREE_YEARS \ + --payment-option PARTIAL_UPFRONT + +Output:: + + { + "Recommendations": [], + "Metadata": { + "GenerationTimestamp": "2018-08-08T15:20:57Z", + "RecommendationId": "00d59dde-a1ad-473f-8ff2-iexample3330b" + } + } diff --git a/bin/awscli/examples/ce/get-reservation-utilization.rst b/bin/awscli/examples/ce/get-reservation-utilization.rst new file mode 100644 index 00000000..485d7a79 --- /dev/null +++ b/bin/awscli/examples/ce/get-reservation-utilization.rst @@ -0,0 +1,36 @@ +**To retrieve the reservation utilization for your account** + +The following ``get-reservation-utilization`` example retrieves the RI utilization for all t2.nano instance types from 2018-03-01 to 2018-08-01 for the account. :: + + aws ce get-reservation-utilization \ + --time-period Start=2018-03-01,End=2018-08-01 \ + --filter file://filters.json + +Contents of ``filters.json``:: + + { + "Dimensions": { + "Key": "INSTANCE_TYPE", + "Values": [ + "t2.nano" + ] + } + } + +Output:: + + { + "Total": { + "TotalAmortizedFee": "0", + "UtilizationPercentage": "0", + "PurchasedHours": "0", + "NetRISavings": "0", + "TotalActualHours": "0", + "AmortizedRecurringFee": "0", + "UnusedHours": "0", + "TotalPotentialRISavings": "0", + "OnDemandCostOfRIHoursUsed": "0", + "AmortizedUpfrontFee": "0" + }, + "UtilizationsByTime": [] + } diff --git a/bin/awscli/examples/ce/get-tags.rst b/bin/awscli/examples/ce/get-tags.rst new file mode 100644 index 00000000..5658514c --- /dev/null +++ b/bin/awscli/examples/ce/get-tags.rst @@ -0,0 +1,18 @@ +**To retrieve keys and values for a cost allocation tag** + +This example retrieves all cost allocation tags with a key of "Project" and a value that contains "secretProject". + +Command:: + + aws ce get-tags --search-string secretProject --time-period Start=2017-01-01,End=2017-05-18 --tag-key Project + +Output:: + + { + "ReturnSize": 2, + "Tags": [ + "secretProject1", + "secretProject2" + ], + "TotalSize": 2 + } diff --git a/bin/awscli/examples/chime/batch-suspend-user.rst b/bin/awscli/examples/chime/batch-suspend-user.rst new file mode 100644 index 00000000..58697578 --- /dev/null +++ b/bin/awscli/examples/chime/batch-suspend-user.rst @@ -0,0 +1,13 @@ +**To suspend multiple users** + +The following ``batch-suspend-user`` example suspends the listed users from the specified Amazon Chime account. :: + + aws chime batch-suspend-user \ + --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ + --user-id-list "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE" "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE" + +Output:: + + { + "UserErrors": [] + } diff --git a/bin/awscli/examples/chime/batch-unsuspend-user.rst b/bin/awscli/examples/chime/batch-unsuspend-user.rst new file mode 100644 index 00000000..4f1241be --- /dev/null +++ b/bin/awscli/examples/chime/batch-unsuspend-user.rst @@ -0,0 +1,14 @@ +**To unsuspend multiple users** + +The following ``batch-unsuspend-user`` example removes any previous suspension for the listed users on the specified Amazon Chime account. :: + + aws chime batch-unsuspend-user \ + --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ + --user-id-list "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE" "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE" + +Output:: + + { + "UserErrors": [] + } + diff --git a/bin/awscli/examples/chime/batch-update-user.rst b/bin/awscli/examples/chime/batch-update-user.rst new file mode 100644 index 00000000..90f6cdfb --- /dev/null +++ b/bin/awscli/examples/chime/batch-update-user.rst @@ -0,0 +1,13 @@ +**To update multiple users in a single command** + +The following ``batch-update-user`` example updates the ``LicenseType`` for each of the listed users in the specified Amazon Chime account. :: + + aws chime batch-update-user \ + --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE + --update-user-request-items "UserId=a1b2c3d4-5678-90ab-cdef-22222EXAMPLE,LicenseType=Basic" "UserId=a1b2c3d4-5678-90ab-cdef-33333EXAMPLE,LicenseType=Basic" + +Output:: + + { + "UserErrors": [] + } diff --git a/bin/awscli/examples/chime/create-account.rst b/bin/awscli/examples/chime/create-account.rst new file mode 100644 index 00000000..0d9e7bf2 --- /dev/null +++ b/bin/awscli/examples/chime/create-account.rst @@ -0,0 +1,24 @@ +**To create an account** + +The following ``create-account`` example creates a new Amazon Chime account under the administrator's AWS account. :: + + aws chime create-account --name MyChimeAccount + +Output:: + + { + "Account": { + "AwsAccountId": "111122223333", + "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "Name": "MyChimeAccount", + "AccountType": "Team", + "CreatedTimestamp": "2019-01-04T17:11:22.003Z", + "DefaultLicense": "Pro", + "SupportedLicenses": [ + "Basic", + "Pro" + ] + } + } + +For more information, see `Getting Started `_ in the *Amazon Chime Administration Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/chime/delete-account.rst b/bin/awscli/examples/chime/delete-account.rst new file mode 100644 index 00000000..510e6c04 --- /dev/null +++ b/bin/awscli/examples/chime/delete-account.rst @@ -0,0 +1,9 @@ +**To delete an account** + +The following ``delete-account`` example deletes the specified account. :: + + aws chime delete-account --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE + +This command produces no output. + +For more information, see `Deleting Your Account `_ in the *Amazon Chime Administration Guide*. diff --git a/bin/awscli/examples/chime/get-account-settings.rst b/bin/awscli/examples/chime/get-account-settings.rst new file mode 100644 index 00000000..42b88b97 --- /dev/null +++ b/bin/awscli/examples/chime/get-account-settings.rst @@ -0,0 +1,16 @@ +**To retrieve settings for an account** + +The following ``get-account-settings`` example retrieves the account settings for the specified account. :: + + aws chime get-account-settings --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE + +Output:: + + { + "AccountSettings": { + "DisableRemoteControl": false, + "EnableDialOut": false + } + } + +For more information, see `Managing Your Amazon Chime Accounts `_ in the *Amazon Chime Administration Guide*. diff --git a/bin/awscli/examples/chime/get-account.rst b/bin/awscli/examples/chime/get-account.rst new file mode 100644 index 00000000..6ec4bf11 --- /dev/null +++ b/bin/awscli/examples/chime/get-account.rst @@ -0,0 +1,24 @@ +**To retrieve the details for an account** + +The following ``get-account`` example retrieves the details for the specified Amazon Chime account. :: + + aws chime get-account --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE + +Output:: + + { + "Account": { + "AwsAccountId": "111122223333", + "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "Name": "EnterpriseDirectory", + "AccountType": "EnterpriseDirectory", + "CreatedTimestamp": "2018-12-20T18:38:02.181Z", + "DefaultLicense": "Pro", + "SupportedLicenses": [ + "Basic", + "Pro" + ] + } + } + +For more information, see `Managing Your Amazon Chime Accounts `_ in the *Amazon Chime Administration Guide*. diff --git a/bin/awscli/examples/chime/get-user.rst b/bin/awscli/examples/chime/get-user.rst new file mode 100644 index 00000000..8b328957 --- /dev/null +++ b/bin/awscli/examples/chime/get-user.rst @@ -0,0 +1,24 @@ +**To get details about a user** + +The following ``get-user`` example retrieves the details for the specified user. :: + + aws chime get-user \ + --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ + --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE + +Output:: + + { + "User": { + "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", + "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "PrimaryEmail": "marthar@example.com", + "DisplayName": "Martha Rivera", + "LicenseType": "Pro", + "UserRegistrationStatus": "Registered", + "RegisteredOn": "2018-12-20T18:45:25.231Z", + "PersonalPIN": "XXXXXXXXXX" + } + } + +For more information, see `Managing Users `_ in the *Amazon Chime Administration Guide*. diff --git a/bin/awscli/examples/chime/invite-users.rst b/bin/awscli/examples/chime/invite-users.rst new file mode 100644 index 00000000..76324a4e --- /dev/null +++ b/bin/awscli/examples/chime/invite-users.rst @@ -0,0 +1,28 @@ +**To invite users to join Amazon Chime** + +The following ``invite-users`` example sends an email to invite a user to the specified Amazon Chime account. :: + + aws chime invite-users \ + --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ + --user-email-list "alejandror@example.com" "janed@example.com" + +Output:: + + { + "Invites": [ + { + "InviteId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", + "Status": "Pending", + "EmailAddress": "alejandror@example.com", + "EmailStatus": "Sent" + } + { + "InviteId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", + "Status": "Pending", + "EmailAddress": "janed@example.com", + "EmailStatus": "Sent" + } + ] + } + +For more information, see `Inviting and Suspending Users `_ in the *Amazon Chime Administration Guide*. diff --git a/bin/awscli/examples/chime/list-accounts.rst b/bin/awscli/examples/chime/list-accounts.rst new file mode 100644 index 00000000..06fda02b --- /dev/null +++ b/bin/awscli/examples/chime/list-accounts.rst @@ -0,0 +1,38 @@ +**To get a list of accounts** + +The following ``list-accounts`` example retrieves a list of the Amazon Chime accounts in the administrator's AWS account. :: + + aws chime list-accounts + +Output:: + + { + "Accounts": [ + { + "AwsAccountId": "111122223333", + "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "Name": "First Chime Account", + "AccountType": "EnterpriseDirectory", + "CreatedTimestamp": "2018-12-20T18:38:02.181Z", + "DefaultLicense": "Pro", + "SupportedLicenses": [ + "Basic", + "Pro" + ] + }, + { + "AwsAccountId": "111122223333", + "AccountId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", + "Name": "Second Chime Account", + "AccountType": "Team", + "CreatedTimestamp": "2018-09-04T21:44:22.292Z", + "DefaultLicense": "Pro", + "SupportedLicenses": [ + "Basic", + "Pro" + ] + } + ] + } + +For more information, see `Managing Your Amazon Chime Accounts `_ in the *Amazon Chime Administration Guide*. diff --git a/bin/awscli/examples/chime/list-users.rst b/bin/awscli/examples/chime/list-users.rst new file mode 100644 index 00000000..8e908207 --- /dev/null +++ b/bin/awscli/examples/chime/list-users.rst @@ -0,0 +1,50 @@ +**To list the users in an account** + +The following ``list-users`` example lists the users for the specified Amazon Chime account. :: + + aws chime list-users --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE + +Output:: + + { + "Users": [ + { + "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", + "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "PrimaryEmail": "mariag@example.com", + "DisplayName": "Maria Garcia", + "LicenseType": "Pro", + "UserRegistrationStatus": "Registered", + "RegisteredOn": "2018-12-20T18:45:25.231Z" + }, + { + "UserId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", + "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "PrimaryEmail": "richardr@example.com", + "DisplayName": "Richard Roe", + "LicenseType": "Pro", + "UserRegistrationStatus": "Registered", + "RegisteredOn": "2018-12-20T18:45:45.415Z" + }, + { + "UserId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE", + "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "PrimaryEmail": "saanvis@example.com", + "DisplayName": "Saanvi Sarkar", + "LicenseType": "Basic", + "UserRegistrationStatus": "Registered", + "RegisteredOn": "2018-12-20T18:46:57.747Z" + }, + { + "UserId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE", + "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "PrimaryEmail": "wxiulan@example.com", + "DisplayName": "Wang Xiulan", + "LicenseType": "Basic", + "UserRegistrationStatus": "Registered", + "RegisteredOn": "2018-12-20T18:47:15.390Z" + } + ] + } + +For more information, see `Managing Users `_ in the *Amazon Chime Administration Guide*. diff --git a/bin/awscli/examples/chime/logout-user.rst b/bin/awscli/examples/chime/logout-user.rst new file mode 100644 index 00000000..10db1fbf --- /dev/null +++ b/bin/awscli/examples/chime/logout-user.rst @@ -0,0 +1,9 @@ +**To log out a user** + +The following ``logout-user`` example logs out the specified user. :: + + aws chime logout-user \ + --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ + --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE + +This command produces no output. diff --git a/bin/awscli/examples/chime/reset-personal-pin.rst b/bin/awscli/examples/chime/reset-personal-pin.rst new file mode 100644 index 00000000..ddbbc005 --- /dev/null +++ b/bin/awscli/examples/chime/reset-personal-pin.rst @@ -0,0 +1,24 @@ +**To reset a user's personal meeting PIN** + +The following ``reset-personal-pin`` example resets the specified user's personal meeting PIN. :: + + aws chime reset-personal-pin \ + --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE + --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE + +Output:: + + { + "User": { + "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", + "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "PrimaryEmail": "mateo@example.com", + "DisplayName": "Mateo Jackson", + "LicenseType": "Pro", + "UserRegistrationStatus": "Registered", + "RegisteredOn": "2018-12-20T18:45:25.231Z", + "PersonalPIN": "XXXXXXXXXX" + } + } + +For more information, see `Changing Personal Meeting PINs `_ in the *Amazon Chime Administration Guide*. diff --git a/bin/awscli/examples/chime/update-account-settings.rst b/bin/awscli/examples/chime/update-account-settings.rst new file mode 100644 index 00000000..4e241463 --- /dev/null +++ b/bin/awscli/examples/chime/update-account-settings.rst @@ -0,0 +1,9 @@ +**To update the settings for your account** + +The following ``update-account-settings`` example disables the remote control of shared screens for the specified Amazon Chime account. :: + + aws chime update-account-settings \ + --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ + --account-settings DisableRemoteControl=true + +This command produces no output. \ No newline at end of file diff --git a/bin/awscli/examples/chime/update-account.rst b/bin/awscli/examples/chime/update-account.rst new file mode 100644 index 00000000..ad2eeb04 --- /dev/null +++ b/bin/awscli/examples/chime/update-account.rst @@ -0,0 +1,24 @@ +**To update an account** + +The following ``update-account`` example updates the specified account name. :: + + aws chime update-account --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE --name MyAccountName + +Output:: + + { + "Account": { + "AwsAccountId": "111122223333", + "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "Name": "MyAccountName", + "AccountType": "Team", + "CreatedTimestamp": "2018-09-04T21:44:22.292Z", + "DefaultLicense": "Pro", + "SupportedLicenses": [ + "Basic", + "Pro" + ] + } + } + +For more information, see `Renaming Your Account `_ in the *Amazon Chime Administration Guide*. diff --git a/bin/awscli/examples/chime/update-user.rst b/bin/awscli/examples/chime/update-user.rst new file mode 100644 index 00000000..e7134698 --- /dev/null +++ b/bin/awscli/examples/chime/update-user.rst @@ -0,0 +1,18 @@ +**To update user details** + +This example updates the specified details for the specified user. + +Command:: + + aws chime update-user \ + --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ + --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE \ + --license-type "Basic" + +Output:: + + { + "User": { + "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" + } + } diff --git a/bin/awscli/examples/cloud9/describe-environments.rst b/bin/awscli/examples/cloud9/describe-environments.rst index 2564a7d6..a9dadc10 100644 --- a/bin/awscli/examples/cloud9/describe-environments.rst +++ b/bin/awscli/examples/cloud9/describe-environments.rst @@ -11,19 +11,26 @@ Output:: { "environments": [ { + "id": "685f892f431b45c2b28cb69eadcdb0EX", + "name": "my-demo-ec2-env", "description": "Created from CodeStar.", - "ownerArn": "arn:aws:iam::123456789012:user/MyDemoUser", "type": "ec2", - "id": "685f892f431b45c2b28cb69eadcdb0EX", "arn": "arn:aws:cloud9:us-east-1:123456789012:environment:685f892f431b45c2b28cb69eadcdb0EX", - "name": "my-demo-ec2-env" + "ownerArn": "arn:aws:iam::123456789012:user/MyDemoUser", + "lifecycle": { + "status": "CREATED" + } }, { - "ownerArn": "arn:aws:iam::123456789012:user/MyDemoUser", - "type": "ssh", "id": "349c86d4579e4e7298d500ff57a6b2EX", + "name": my-demo-ssh-env", + "description": "", + "type": "ssh", "arn": "arn:aws:cloud9:us-east-1:123456789012:environment:349c86d4579e4e7298d500ff57a6b2EX", - "name": my-demo-ssh-env" + "ownerArn": "arn:aws:iam::123456789012:user/MyDemoUser", + "lifecycle": { + "status": "CREATED" + } } ] } \ No newline at end of file diff --git a/bin/awscli/examples/cloudformation/_package_description.rst b/bin/awscli/examples/cloudformation/_package_description.rst index b2b0f347..88ff2fe9 100644 --- a/bin/awscli/examples/cloudformation/_package_description.rst +++ b/bin/awscli/examples/cloudformation/_package_description.rst @@ -21,6 +21,7 @@ This command can upload local artifacts referenced in the following places: - ``Location`` parameter for the ``AWS::Include`` transform - ``SourceBundle`` property for the ``AWS::ElasticBeanstalk::ApplicationVersion`` resource - ``TemplateURL`` property for the ``AWS::CloudFormation::Stack`` resource + - ``Command.ScriptLocation`` property for the ``AWS::Glue::Job`` resource To specify a local artifact in your template, specify a path to a local file or folder, @@ -29,7 +30,7 @@ that is relative to your template's location. For example, if your AWS Lambda function source code is in the ``/home/user/code/lambdafunction/`` folder, specify -`` CodeUri: /home/user/code/lambdafunction`` for the +``CodeUri: /home/user/code/lambdafunction`` for the ``AWS::Serverless::Function`` resource. The command returns a template and replaces the local path with the S3 location: ``CodeUri: s3://mybucket/lambdafunction.zip``. diff --git a/bin/awscli/examples/codebuild/batch-delete-builds.rst b/bin/awscli/examples/codebuild/batch-delete-builds.rst new file mode 100644 index 00000000..6b94a52b --- /dev/null +++ b/bin/awscli/examples/codebuild/batch-delete-builds.rst @@ -0,0 +1,22 @@ +**To delete builds in AWS CodeBuild.** + +The following ``batch-delete-builds`` example deletes builds in CodeBuild with the specified IDs. :: + + aws codebuild batch-delete-builds --ids my-build-project-one:a1b2c3d4-5678-9012-abcd-11111EXAMPLE my-build-project-two:a1b2c3d4-5678-9012-abcd-22222EXAMPLE + +Output:: + + { + "buildsNotDeleted": [ + { + "id": "arn:aws:codebuild:us-west-2:123456789012:build/my-build-project-one:a1b2c3d4-5678-9012-abcd-11111EXAMPLE", + "statusCode": "BUILD_IN_PROGRESS" + } + ], + "buildsDeleted": [ + "arn:aws:codebuild:us-west-2:123456789012:build/my-build-project-two:a1b2c3d4-5678-9012-abcd-22222EXAMPLE" + ] + } + +For more information, see `Delete Builds (AWS CLI) `_ in the *AWS CodeBuild User Guide*. + diff --git a/bin/awscli/examples/codebuild/batch-get-builds.rst b/bin/awscli/examples/codebuild/batch-get-builds.rst new file mode 100644 index 00000000..80e00f20 --- /dev/null +++ b/bin/awscli/examples/codebuild/batch-get-builds.rst @@ -0,0 +1,369 @@ +**To view details of builds in AWS CodeBuild.** + +The following ``batch-get-builds`` example gets information about builds in CodeBuild with the specified IDs. :: + + aws codebuild batch-get-builds --ids codebuild-demo-project:e9c4f4df-3f43-41d2-ab3a-60fe2EXAMPLE codebuild-demo-project:815e755f-bade-4a7e-80f0-efe51EXAMPLE + +Output:: + + { + "buildsNotFound": [], + "builds": [ + { + "artifacts": { + "md5sum": "0e95edf915048a0c22efe6d139fff837", + "location": "arn:aws:s3:::codepipeline-us-west-2-820783811474/CodeBuild-Python-Pip/BuildArtif/6DJsqQa", + "encryptionDisabled": false, + "sha256sum": "cfa0df33a090966a737f64ae4fe498969fdc842a0c9aec540bf93c37ac0d05a2" + }, + "logs": { + "cloudWatchLogs": { + "status": "ENABLED" + }, + "s3Logs": { + "status": "DISABLED" + }, + "streamName": "46472baf-8f6b-43c2-9255-b3b963af2732", + "groupName": "/aws/codebuild/codebuild-demo-project", + "deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logEvent:group=/aws/codebuild/codebuild-demo-project;stream=46472baf-8f6b-43c2-9255-b3b963af2732" + }, + "timeoutInMinutes": 60, + "environment": { + "privilegedMode": false, + "computeType": "BUILD_GENERAL1_MEDIUM", + "image": "aws/codebuild/windows-base:1.0", + "environmentVariables": [], + "type": "WINDOWS_CONTAINER" + }, + "projectName": "codebuild-demo-project", + "buildComplete": true, + "source": { + "gitCloneDepth": 1, + "insecureSsl": false, + "type": "CODEPIPELINE" + }, + "buildStatus": "SUCCEEDED", + "secondaryArtifacts": [], + "phases": [ + { + "durationInSeconds": 0, + "startTime": 1548717462.122, + "phaseType": "SUBMITTED", + "endTime": 1548717462.484, + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 0, + "startTime": 1548717462.484, + "phaseType": "QUEUED", + "endTime": 1548717462.775, + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 34, + "endTime": 1548717496.909, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548717462.775, + "phaseType": "PROVISIONING", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 15, + "endTime": 1548717512.555, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548717496.909, + "phaseType": "DOWNLOAD_SOURCE", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 0, + "endTime": 1548717512.734, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548717512.555, + "phaseType": "INSTALL", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 0, + "endTime": 1548717512.924, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548717512.734, + "phaseType": "PRE_BUILD", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 9, + "endTime": 1548717522.254, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548717512.924, + "phaseType": "BUILD", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 3, + "endTime": 1548717525.498, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548717522.254, + "phaseType": "POST_BUILD", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 9, + "endTime": 1548717534.646, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548717525.498, + "phaseType": "UPLOAD_ARTIFACTS", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 2, + "endTime": 1548717536.846, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548717534.646, + "phaseType": "FINALIZING", + "phaseStatus": "SUCCEEDED" + }, + { + "startTime": 1548717536.846, + "phaseType": "COMPLETED" + } + ], + "startTime": 1548717462.122, + "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", + "initiator": "codepipeline/CodeBuild-Pipeline", + "secondarySources": [], + "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", + "currentPhase": "COMPLETED", + "id": "codebuild-demo-project:e9c4f4df-3f43-41d2-ab3a-60fe2EXAMPLE", + "cache": { + "type": "NO_CACHE" + }, + "sourceVersion": "arn:aws:s3:::codepipeline-us-west-2-820783811474/CodeBuild-Python-Pip/SourceArti/1TspnN3.zip", + "endTime": 1548717536.846, + "arn": "arn:aws:codebuild:us-west-2:123456789012:build/codebuild-demo-project:e9c4f4df-3f43-41d2-ab3a-60fe2EXAMPLE", + "queuedTimeoutInMinutes": 480, + "resolvedSourceVersion": "f2194c1757bbdcb0f8f229254a4b3c8b27d43e0b" + }, + { + "artifacts": { + "md5sum": "", + "overrideArtifactName": false, + "location": "arn:aws:s3:::my-artifacts/codebuild-demo-project", + "encryptionDisabled": false, + "sha256sum": "" + }, + "logs": { + "cloudWatchLogs": { + "status": "ENABLED" + }, + "s3Logs": { + "status": "DISABLED" + }, + "streamName": "4dea3ca4-20ec-4898-b22a-a9eb9292775d", + "groupName": "/aws/codebuild/codebuild-demo-project", + "deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logEvent:group=/aws/codebuild/codebuild-demo-project;stream=4dea3ca4-20ec-4898-b22a-a9eb9292775d" + }, + "timeoutInMinutes": 60, + "environment": { + "privilegedMode": false, + "computeType": "BUILD_GENERAL1_MEDIUM", + "image": "aws/codebuild/windows-base:1.0", + "environmentVariables": [], + "type": "WINDOWS_CONTAINER" + }, + "projectName": "codebuild-demo-project", + "buildComplete": true, + "source": { + "gitCloneDepth": 1, + "location": "https://github.com/my-repo/codebuild-demo-project.git", + "insecureSsl": false, + "reportBuildStatus": false, + "type": "GITHUB" + }, + "buildStatus": "SUCCEEDED", + "secondaryArtifacts": [], + "phases": [ + { + "durationInSeconds": 0, + "startTime": 1548716241.89, + "phaseType": "SUBMITTED", + "endTime": 1548716242.241, + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 0, + "startTime": 1548716242.241, + "phaseType": "QUEUED", + "endTime": 1548716242.536, + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 33, + "endTime": 1548716276.171, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548716242.536, + "phaseType": "PROVISIONING", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 15, + "endTime": 1548716291.809, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548716276.171, + "phaseType": "DOWNLOAD_SOURCE", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 0, + "endTime": 1548716291.993, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548716291.809, + "phaseType": "INSTALL", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 0, + "endTime": 1548716292.191, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548716291.993, + "phaseType": "PRE_BUILD", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 9, + "endTime": 1548716301.622, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548716292.191, + "phaseType": "BUILD", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 3, + "endTime": 1548716304.783, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548716301.622, + "phaseType": "POST_BUILD", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 8, + "endTime": 1548716313.775, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548716304.783, + "phaseType": "UPLOAD_ARTIFACTS", + "phaseStatus": "SUCCEEDED" + }, + { + "durationInSeconds": 2, + "endTime": 1548716315.935, + "contexts": [ + { + "statusCode": "", + "message": "" + } + ], + "startTime": 1548716313.775, + "phaseType": "FINALIZING", + "phaseStatus": "SUCCEEDED" + }, + { + "startTime": 1548716315.935, + "phaseType": "COMPLETED" + } + ], + "startTime": 1548716241.89, + "secondarySourceVersions": [], + "initiator": "my-codebuild-project", + "arn": "arn:aws:codebuild:us-west-2:123456789012:build/codebuild-demo-project:815e755f-bade-4a7e-80f0-efe51EXAMPLE", + "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", + "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", + "currentPhase": "COMPLETED", + "id": "codebuild-demo-project:815e755f-bade-4a7e-80f0-efe51EXAMPLE", + "cache": { + "type": "NO_CACHE" + }, + "endTime": 1548716315.935, + "secondarySources": [], + "queuedTimeoutInMinutes": 480, + "resolvedSourceVersion": "f2194c1757bbdcb0f8f229254a4b3c8b27d43e0b" + } + ] + } + +For more information, see `View Build Details (AWS CLI) `_ in the *AWS CodeBuild User Guide*. + diff --git a/bin/awscli/examples/codebuild/batch-get-projects.rst b/bin/awscli/examples/codebuild/batch-get-projects.rst new file mode 100644 index 00000000..b54ff61c --- /dev/null +++ b/bin/awscli/examples/codebuild/batch-get-projects.rst @@ -0,0 +1,89 @@ +**To get a list of AWS CodeBuild build project names.** + +The following ``batch-get-projects`` example gets a list of CodeBuild build projects specified by name. :: + + aws codebuild batch-get-projects --names codebuild-demo-project codebuild-demo-project2 my-other-demo-project + +In the following output, the ``projectsNotFound`` array lists any build project names that were specified, but not found. The ``projects`` array lists details for each build project where information was found. :: + + { + "projectsNotFound": [], + "projects": [ + { + "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", + "name": "codebuild-demo-project2", + "queuedTimeoutInMinutes": 480, + "timeoutInMinutes": 60, + "source": { + "buildspec": "version: 0.2\n\n#env:\n #variables:\n # key: \"value\"\n # key: \"value\"\n #parameter-store:\n # key: \"value\"\n # key:\"value\"\n\nphases:\n #install:\n #commands:\n # - command\n # - command\n #pre_build:\n #commands:\n # - command\n # - command\n build:\n commands:\n # - command\n # - command\n #post_build:\n #commands:\n # - command\n # - command\n#artifacts:\n #files:\n # - location\n # - location\n #name: $(date +%Y-%m-%d)\n #discard-paths: yes\n #base-directory: location\n#cache:\n #paths:\n # - paths", + "type": "NO_SOURCE", + "insecureSsl": false, + "gitCloneDepth": 1 + }, + "artifacts": { + "type": "NO_ARTIFACTS" + }, + "badge": { + "badgeEnabled": false + }, + "lastModified": 1540588091.108, + "created": 1540588091.108, + "arn": "arn:aws:codebuild:us-west-2:123456789012:project/test-for-sample", + "secondarySources": [], + "secondaryArtifacts": [], + "cache": { + "type": "NO_CACHE" + }, + "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-test-role", + "environment": { + "image": "aws/codebuild/java:openjdk-8", + "privilegedMode": true, + "type": "LINUX_CONTAINER", + "computeType": "BUILD_GENERAL1_SMALL", + "environmentVariables": [] + }, + "tags": [] + }, + { + "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", + "name": "my-other-demo-project", + "queuedTimeoutInMinutes": 480, + "timeoutInMinutes": 60, + "source": { + "location": "https://github.com/iversonic/codedeploy-sample.git", + "reportBuildStatus": false, + "buildspec": "buildspec.yml", + "insecureSsl": false, + "gitCloneDepth": 1, + "type": "GITHUB", + "auth": { + "type": "OAUTH" + } + }, + "artifacts": { + "type": "NO_ARTIFACTS" + }, + "badge": { + "badgeEnabled": false + }, + "lastModified": 1523401711.73, + "created": 1523401711.73, + "arn": "arn:aws:codebuild:us-west-2:123456789012:project/Project2", + "cache": { + "type": "NO_CACHE" + }, + "serviceRole": "arn:aws:iam::123456789012:role/service-role/codebuild-Project2-service-role", + "environment": { + "image": "aws/codebuild/nodejs:4.4.7", + "privilegedMode": false, + "type": "LINUX_CONTAINER", + "computeType": "BUILD_GENERAL1_SMALL", + "environmentVariables": [] + }, + "tags": [] + } + ] + } + +For more information, see `View a Build Project's Details (AWS CLI) `_ in the *AWS CodeBuild User Guide*. + diff --git a/bin/awscli/examples/codebuild/create-project.rst b/bin/awscli/examples/codebuild/create-project.rst new file mode 100755 index 00000000..e500233b --- /dev/null +++ b/bin/awscli/examples/codebuild/create-project.rst @@ -0,0 +1,112 @@ +**Example 1: To create an AWS CodeBuild build project** + +The following ``create-project`` example creates a CodeBuild build project using source files from an S3 bucket :: + + aws codebuild create-project \ + --name "my-demo-project" \ + --source "{\"type\": \"S3\",\"location\": \"codebuild-us-west-2-123456789012-input-bucket/my-source.zip\"}" \ + --artifacts {"\"type\": \"S3\",\"location\": \"codebuild-us-west-2-123456789012-output-bucket\""} \ + --environment "{\"type\": \"LINUX_CONTAINER\",\"image\": \"aws/codebuild/standard:1.0\",\"computeType\": \"BUILD_GENERAL1_SMALL\"}" \ + --service-role "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role" + +Output:: + + { + "project": { + "arn": "arn:aws:codebuild:us-west-2:123456789012:project/my-demo-project", + "name": "my-cli-demo-project", + "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", + "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", + "lastModified": 1556839783.274, + "badge": { + "badgeEnabled": false + }, + "queuedTimeoutInMinutes": 480, + "environment": { + "image": "aws/codebuild/standard:1.0", + "computeType": "BUILD_GENERAL1_SMALL", + "type": "LINUX_CONTAINER", + "imagePullCredentialsType": "CODEBUILD", + "privilegedMode": false, + "environmentVariables": [] + }, + "artifacts": { + "location": "codebuild-us-west-2-123456789012-output-bucket", + "name": "my-cli-demo-project", + "namespaceType": "NONE", + "type": "S3", + "packaging": "NONE", + "encryptionDisabled": false + }, + "source": { + "type": "S3", + "location": "codebuild-us-west-2-123456789012-input-bucket/my-source.zip", + "insecureSsl": false + }, + "timeoutInMinutes": 60, + "cache": { + "type": "NO_CACHE" + }, + "created": 1556839783.274 + } + } + +**Example 2: To create an AWS CodeBuild build project using a JSON input file for the parameters** + +The following ``create-project`` example creates a CodeBuild build project by passing all of the required parameters in a JSON input file. Create the input file template by running the command with only the ``--generate-cli-skeleton parameter``. :: + + aws codebuild create-project --cli-input-json file://create-project.json + +The input JSON file ``create-project.json`` contains the following content:: + + { + "name": "codebuild-demo-project", + "source": { + "type": "S3", + "location": "codebuild-region-ID-account-ID-input-bucket/MessageUtil.zip" + }, + "artifacts": { + "type": "S3", + "location": "codebuild-region-ID-account-ID-output-bucket" + }, + "environment": { + "type": "LINUX_CONTAINER", + "image": "aws/codebuild/standard:1.0", + "computeType": "BUILD_GENERAL1_SMALL" + }, + "serviceRole": "serviceIAMRole" + } + +Output:: + + { + "project": { + "name": "codebuild-demo-project", + "serviceRole": "serviceIAMRole", + "tags": [], + "artifacts": { + "packaging": "NONE", + "type": "S3", + "location": "codebuild-region-ID-account-ID-output-bucket", + "name": "message-util.zip" + }, + "lastModified": 1472661575.244, + "timeoutInMinutes": 60, + "created": 1472661575.244, + "environment": { + "computeType": "BUILD_GENERAL1_SMALL", + "image": "aws/codebuild/standard:1.0", + "type": "LINUX_CONTAINER", + "environmentVariables": [] + }, + "source": { + "type": "S3", + "location": "codebuild-region-ID-account-ID-input-bucket/MessageUtil.zip" + }, + "encryptionKey": "arn:aws:kms:region-ID:account-ID:alias/aws/s3", + "arn": "arn:aws:codebuild:region-ID:account-ID:project/codebuild-demo-project" + } + } + +For more information, see `Create a Build Project (AWS CLI) `_ in the *AWS CodeBuild User Guide*. + diff --git a/bin/awscli/examples/codebuild/create-webhook.rst b/bin/awscli/examples/codebuild/create-webhook.rst new file mode 100755 index 00000000..449fcd38 --- /dev/null +++ b/bin/awscli/examples/codebuild/create-webhook.rst @@ -0,0 +1,50 @@ +**To create webhook filters for an AWS CodeBuild project** + +The following ``create-webhook`` example creates a webhook for a CodeBuild project named ``my-project`` that has two filter groups. The first filter group specifies pull requests that are created, updated, or reopened on branches with Git reference names that match the regular expression ``^refs/heads/master$`` and head references that match ``^refs/heads/myBranch$``. The second filter group specifies push requests on branches with Git reference names that do not match the regular expression ``^refs/heads/myBranch$``. :: + + aws codebuild create-webhook \ + --project-name my-project \ + --filter-groups "[[{\"type\":\"EVENT\",\"pattern\":\"PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED\"},{\"type\":\"HEAD_REF\",\"pattern\":\"^refs/heads/myBranch$\",\"excludeMatchedPattern\":true},{\"type\":\"BASE_REF\",\"pattern\":\"^refs/heads/master$\",\"excludeMatchedPattern\":true}],[{\"type\":\"EVENT\",\"pattern\":\"PUSH\"},{\"type\":\"HEAD_REF\",\"pattern\":\"^refs/heads/myBranch$\",\"excludeMatchedPattern\":true}]]" + +Output:: + + { + "webhook": { + "payloadUrl": "https://codebuild.us-west-2.amazonaws.com/webhooks?t=eyJlbmNyeXB0ZWREYXRhIjoiVVl5MGtoeGRwSzZFRXl2Wnh4bld1Z0tKZ291TVpQNEtFamQ3RDlDYWpRaGIreVFrdm9EQktIVk1NeHJEWEpmUDUrVUNOMUIyRHJRc1VxcHJ6QlNDSnljPSIsIml2UGFyYW1ldGVyU3BlYyI6InN4Tm1SeUt5MUhaUVRWbGciLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&v=1", + "url": "https://api.github.com/repos/iversonic/codedeploy-sample/hooks/105190656", + "lastModifiedSecret": 1556311319.069, + "filterGroups": [ + [ + { + "type": "EVENT", + "pattern": "PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED", + "excludeMatchedPattern": false + }, + { + "type": "HEAD_REF", + "pattern": "refs/heads/myBranch$", + "excludeMatchedPattern": true + }, + { + "type": "BASE_REF", + "pattern": "refs/heads/master$", + "excludeMatchedPattern": true + } + ], + [ + { + "type": "EVENT", + "pattern": "PUSH", + "excludeMatchedPattern": false + }, + { + "type": "HEAD_REF", + "pattern": "refs/heads/myBranch$", + "excludeMatchedPattern": true + } + ] + ] + } + } + +For more information, see `Filter GitHub Webhook Events (SDK) `_ in the *AWS CodeBuild User Guide*. diff --git a/bin/awscli/examples/codebuild/delete-project.rst b/bin/awscli/examples/codebuild/delete-project.rst new file mode 100755 index 00000000..6260cabe --- /dev/null +++ b/bin/awscli/examples/codebuild/delete-project.rst @@ -0,0 +1,9 @@ +**To delete an AWS CodeBuild build project** + +The following ``delete-project`` example deletes the specified CodeBuild build project. :: + + aws codebuild delete-project --name my-project + +This command produces no output. + +For more information, see `Delete a Build Project (AWS CLI) `_ in the *AWS CodeBuild User Guide*. diff --git a/bin/awscli/examples/codebuild/delete-source-credentials.rst b/bin/awscli/examples/codebuild/delete-source-credentials.rst new file mode 100755 index 00000000..3d303364 --- /dev/null +++ b/bin/awscli/examples/codebuild/delete-source-credentials.rst @@ -0,0 +1,13 @@ +**To disconnect from a source provider and remove its access tokens.** + +The following ``delete-source-credentials`` example disconnects from a source provider and removes its tokens. The ARN of source credentials used to connect to the source provider determines which source credentials. :: + + aws codebuild delete-source-credentials --arn arn-of-your-credentials + +Output:: + + { + "arn": "arn:aws:codebuild:your-region:your-account-id:token/your-server-type" + } + +For more information, see `Connect Source Providers with Access Tokens (CLI) `_ in the *AWS CodeBuild User Guide*. diff --git a/bin/awscli/examples/codebuild/delete-webhook.rst b/bin/awscli/examples/codebuild/delete-webhook.rst new file mode 100755 index 00000000..b5f0afd2 --- /dev/null +++ b/bin/awscli/examples/codebuild/delete-webhook.rst @@ -0,0 +1,9 @@ +**To delete a webhook filter from an AWS CodeBuild project** + +The following ``delete-webhook`` example deletes a webhook from the specified CodeBuild project. :: + + aws codebuild delete-webhook --project-name my-project + +This command produces no output. + +For more information, see `Stop Running Builds Automatically (AWS CLI) `_ in the *AWS CodeBuild User Guide*. diff --git a/bin/awscli/examples/codebuild/import-source-credentials.rst b/bin/awscli/examples/codebuild/import-source-credentials.rst new file mode 100755 index 00000000..69b0f186 --- /dev/null +++ b/bin/awscli/examples/codebuild/import-source-credentials.rst @@ -0,0 +1,13 @@ +**Connect an AWS CodeBuild user to a source provider by importing credentials for the source provider.** + +The following ``import-source-credentials`` example imports a token for a Bitbucket repository that uses BASIC_AUTH for its authentication type. :: + + aws codebuild import-source-credentials --server-type BITBUCKET --auth-type BASIC_AUTH --token my-Bitbucket-password --username my-Bitbucket-username + +Output:: + + { + "arn": "arn:aws:codebuild:us-west-2:123456789012:token/bitbucket" + } + +For more information, see `Connect Source Providers with Access Tokens (CLI) `_ in the *AWS CodeBuild User Guide*. diff --git a/bin/awscli/examples/codebuild/invalidate-project-cache.rst b/bin/awscli/examples/codebuild/invalidate-project-cache.rst new file mode 100755 index 00000000..26436b1d --- /dev/null +++ b/bin/awscli/examples/codebuild/invalidate-project-cache.rst @@ -0,0 +1,9 @@ +**To reset the cache for an AWS CodeBuild build project.** + +The following ``invalidate-project-cache`` example resets the cache for the specified CodeBuild project. :: + + aws codebuild invalidate-project-cache --project-name my-project + +This command produces no output. + +For more information, see `Build Caching in CodeBuild `_ in the *AWS CodeBuild User Guide*. diff --git a/bin/awscli/examples/codebuild/list-builds-for-project.rst b/bin/awscli/examples/codebuild/list-builds-for-project.rst new file mode 100755 index 00000000..4db3478f --- /dev/null +++ b/bin/awscli/examples/codebuild/list-builds-for-project.rst @@ -0,0 +1,19 @@ +**To view a list of builds for an AWS CodeBuild build project.** + +The following ``list-builds-for-project`` example lists the build IDs in descending order for the specified CodeBuild build project. :: + + aws codebuild list-builds-for-project --project-name codebuild-demo-project --sort-order DESCENDING + +Output:: + + { + "ids": [ + "codebuild-demo-project:1a2b3c4d-5678-90ab-cdef-11111example", + "codebuild-demo-project:1a2b3c4d-5678-90ab-cdef-22222example", + "codebuild-demo-project:1a2b3c4d-5678-90ab-cdef-33333example", + "codebuild-demo-project:1a2b3c4d-5678-90ab-cdef-44444example", + "codebuild-demo-project:1a2b3c4d-5678-90ab-cdef-55555example" + ] + } + +For more information, see `View a List of Build IDs for a Build Project (AWS CLI) `_ in the *AWS CodeBuild User Guide* diff --git a/bin/awscli/examples/codebuild/list-builds.rst b/bin/awscli/examples/codebuild/list-builds.rst new file mode 100755 index 00000000..d9ae898f --- /dev/null +++ b/bin/awscli/examples/codebuild/list-builds.rst @@ -0,0 +1,35 @@ +**To get a list of AWS CodeBuild builds IDs.** + +The following ``list-builds`` example gets a list of CodeBuild IDs sorted in ascending order. :: + + aws codebuild list-builds --sort-order ASCENDING + +The output includes a ``nextToken`` value which indicates that there is more output available. :: + + { + "nextToken": "4AEA6u7J...The full token has been omitted for brevity...MzY2OA==", + "ids": [ + "codebuild-demo-project:815e755f-bade-4a7e-80f0-efe51EXAMPLE" + "codebuild-demo-project:84a7f3d1-d40e-4956-b4cf-7a9d4EXAMPLE" + ... The full list of build IDs has been omitted for brevity ... + "codebuild-demo-project:931d0b72-bf6f-4040-a472-5c707EXAMPLE" + ] + } + +Run this command again and provide the ``nextToken`` value in the previous response as a parameter to get the next part of the output. Repeat until you don't receive a ``nextToken`` value in the response. :: + + aws codebuild list-builds --sort-order ASCENDING --next-token 4AEA6u7J...The full token has been omitted for brevity...MzY2OA== + +Next part of the output:: + + { + "ids": [ + "codebuild-demo-project:49015049-21cf-4b50-9708-df115EXAMPLE", + "codebuild-demo-project:543e7206-68a3-46d6-a4da-759abEXAMPLE", + ... The full list of build IDs has been omitted for brevity ... + "codebuild-demo-project:c282f198-4582-4b38-bdc0-26f96EXAMPLE" + ] + } + +For more information, see `View a List of Build IDs (AWS CLI) `_ in the *AWS CodeBuild User Guide* + diff --git a/bin/awscli/examples/codebuild/list-curated-environment-images.rst b/bin/awscli/examples/codebuild/list-curated-environment-images.rst new file mode 100755 index 00000000..f1b975a1 --- /dev/null +++ b/bin/awscli/examples/codebuild/list-curated-environment-images.rst @@ -0,0 +1,40 @@ +**To get a list of Docker images managed by AWS CodeBuild that you can use for your builds.** + +The following ``list-curated-environment-images`` example lists the Docker images managed by CodeBuild that can be used for builds.:: + + aws codebuild list-curated-environment-images + +Output:: + + { + "platforms": [ + { + "platform": "AMAZON_LINUX", + "languages": [ + { + "language": "JAVA", + "images": [ + { + "description": "AWS ElasticBeanstalk - Java 7 Running on Amazon Linux 64bit v2.1.3", + "name": "aws/codebuild/eb-java-7-amazonlinux-64:2.1.3", + "versions": [ + "aws/codebuild/eb-java-7-amazonlinux-64:2.1.3-1.0.0" + ] + }, + { + "description": "AWS ElasticBeanstalk - Java 8 Running on Amazon Linux 64bit v2.1.3", + "name": "aws/codebuild/eb-java-8-amazonlinux-64:2.1.3", + "versions": [ + "aws/codebuild/eb-java-8-amazonlinux-64:2.1.3-1.0.0" + ] + }, + ... LIST TRUNCATED FOR BREVITY ... + ] + } + ] + } + ] + } + + +For more information, see `Docker Images Provided by CodeBuild `_ in the *AWS CodeBuild User Guide* diff --git a/bin/awscli/examples/codebuild/list-projects.rst b/bin/awscli/examples/codebuild/list-projects.rst new file mode 100755 index 00000000..13e7f903 --- /dev/null +++ b/bin/awscli/examples/codebuild/list-projects.rst @@ -0,0 +1,33 @@ +**To get a list of AWS CodeBuild build project names.** + +The following ``list-projects`` example gets a list of CodeBuild build projects sorted by name in ascending order. :: + + aws codebuild list-projects --sort-by NAME --sort-order ASCENDING + +The output includes a ``nextToken`` value which indicates that there is more output available. :: + + { + "nextToken": "Ci33ACF6...The full token has been omitted for brevity...U+AkMx8=", + "projects": [ + "codebuild-demo-project", + "codebuild-demo-project2", + ... The full list of build project names has been omitted for brevity ... + "codebuild-demo-project99" + ] + } + +Run this command again and provide the ``nextToken`` value from the previous response as a parameter to get the next part of the output. Repeat until you don't receive a ``nextToken`` value in the response. :: + + aws codebuild list-projects --sort-by NAME --sort-order ASCENDING --next-token Ci33ACF6...The full token has been omitted for brevity...U+AkMx8= + + { + "projects": [ + "codebuild-demo-project100", + "codebuild-demo-project101", + ... The full list of build project names has been omitted for brevity ... + "codebuild-demo-project122" + ] + } + +For more information, see `View a List of Build Project Names (AWS CLI) `_ in the *AWS CodeBuild User Guide*. + diff --git a/bin/awscli/examples/codebuild/list-source-credentials.rst b/bin/awscli/examples/codebuild/list-source-credentials.rst new file mode 100755 index 00000000..0eca272d --- /dev/null +++ b/bin/awscli/examples/codebuild/list-source-credentials.rst @@ -0,0 +1,24 @@ +**To view a list of sourceCredentialsObjects** + +The following ``list-source-credentials`` example lists tokens for an AWS account connected to one Bitbucket account and one GitHub account. Each ``sourceCredentialsInfos`` object in the response contains connected source credentials information. :: + + aws codebuild list-source-credentials + +Output:: + + { + "sourceCredentialsInfos": [ + { + "serverType": "BITBUCKET", + "arn": "arn:aws:codebuild:us-west-2:123456789012:token/bitbucket", + "authType": "BASIC_AUTH" + }, + { + "serverType": "GITHUB", + "arn": "arn:aws:codebuild:us-west-2:123456789012:token/github", + "authType": "OAUTH" + } + ] + } + +For more information, see `Connect Source Providers with Access Tokens (CLI) `_ in the *AWS CodeBuild User Guide*. diff --git a/bin/awscli/examples/codebuild/start-build.rst b/bin/awscli/examples/codebuild/start-build.rst new file mode 100755 index 00000000..b12d87fb --- /dev/null +++ b/bin/awscli/examples/codebuild/start-build.rst @@ -0,0 +1,66 @@ +**To start running a build of an AWS CodeBuild build project.** + +The following ``start-build`` example starts a build for the specified CodeBuild project. The build overrides both the project's setting for the number of minutes the build is allowed to be queued before it times out and the project's artifact settings. :: + + aws codebuild start-build \ + --project-name "my-demo-project" \ + --queued-timeout-in-minutes-override 5 \ + --artifacts-override {"\"type\": \"S3\",\"location\": \"arn:aws:s3:::artifacts-override\",\"overrideArtifactName\":true"} + +Output:: + + { + "build": { + "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", + "buildStatus": "IN_PROGRESS", + "buildComplete": false, + "projectName": "my-demo-project", + "timeoutInMinutes": 60, + "source": { + "insecureSsl": false, + "type": "S3", + "location": "codebuild-us-west-2-123456789012-input-bucket/my-source.zip" + }, + "queuedTimeoutInMinutes": 5, + "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", + "currentPhase": "QUEUED", + "startTime": 1556905683.568, + "environment": { + "computeType": "BUILD_GENERAL1_MEDIUM", + "environmentVariables": [], + "type": "LINUX_CONTAINER", + "privilegedMode": false, + "image": "aws/codebuild/standard:1.0", + "imagePullCredentialsType": "CODEBUILD" + }, + "phases": [ + { + "phaseStatus": "SUCCEEDED", + "startTime": 1556905683.568, + "phaseType": "SUBMITTED", + "durationInSeconds": 0, + "endTime": 1556905684.524 + }, + { + "startTime": 1556905684.524, + "phaseType": "QUEUED" + } + ], + "logs": { + "deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logEvent:group=null;stream=null" + }, + "artifacts": { + "encryptionDisabled": false, + "location": "arn:aws:s3:::artifacts-override/my-demo-project", + "overrideArtifactName": true + }, + "cache": { + "type": "NO_CACHE" + }, + "id": "my-demo-project::12345678-a1b2-c3d4-e5f6-11111EXAMPLE", + "initiator": "my-aws-account-name", + "arn": "arn:aws:codebuild:us-west-2:123456789012:build/my-demo-project::12345678-a1b2-c3d4-e5f6-11111EXAMPLE" + } + } + +For more information, see `Run a Build (AWS CLI) `_ in the *AWS CodeBuild User Guide*. diff --git a/bin/awscli/examples/codebuild/stop-build.rst b/bin/awscli/examples/codebuild/stop-build.rst new file mode 100755 index 00000000..0c519d8c --- /dev/null +++ b/bin/awscli/examples/codebuild/stop-build.rst @@ -0,0 +1,132 @@ +**To stop a build of an AWS CodeBuild build project.** + +The following ``stop-build`` example stops the specified CodeBuild build. :: + + aws codebuild stop-build --id my-demo-project:12345678-a1b2-c3d4-e5f6-11111EXAMPLE + +Output:: + + { + "build": { + "startTime": 1556906956.318, + "initiator": "my-aws-account-name", + "projectName": "my-demo-project", + "currentPhase": "COMPLETED", + "cache": { + "type": "NO_CACHE" + }, + "source": { + "insecureSsl": false, + "location": "codebuild-us-west-2-123456789012-input-bucket/my-source.zip", + "type": "S3" + }, + "id": "my-demo-project:1a2b3c4d-5678-90ab-cdef-11111EXAMPLE", + "endTime": 1556906974.781, + "phases": [ + { + "durationInSeconds": 0, + "phaseType": "SUBMITTED", + "endTime": 1556906956.935, + "phaseStatus": "SUCCEEDED", + "startTime": 1556906956.318 + }, + { + "durationInSeconds": 1, + "phaseType": "QUEUED", + "endTime": 1556906958.272, + "phaseStatus": "SUCCEEDED", + "startTime": 1556906956.935 + }, + { + "phaseType": "PROVISIONING", + "phaseStatus": "SUCCEEDED", + "durationInSeconds": 14, + "contexts": [ + { + "message": "", + "statusCode": "" + } + ], + "endTime": 1556906972.847, + "startTime": 1556906958.272 + }, + { + "phaseType": "DOWNLOAD_SOURCE", + "phaseStatus": "SUCCEEDED", + "durationInSeconds": 0, + "contexts": [ + { + "message": "", + "statusCode": "" + } + ], + "endTime": 1556906973.552, + "startTime": 1556906972.847 + }, + { + "phaseType": "INSTALL", + "phaseStatus": "SUCCEEDED", + "durationInSeconds": 0, + "contexts": [ + { + "message": "", + "statusCode": "" + } + ], + "endTime": 1556906973.75, + "startTime": 1556906973.552 + }, + { + "phaseType": "PRE_BUILD", + "phaseStatus": "SUCCEEDED", + "durationInSeconds": 0, + "contexts": [ + { + "message": "", + "statusCode": "" + } + ], + "endTime": 1556906973.937, + "startTime": 1556906973.75 + }, + { + "durationInSeconds": 0, + "phaseType": "BUILD", + "endTime": 1556906974.781, + "phaseStatus": "STOPPED", + "startTime": 1556906973.937 + }, + { + "phaseType": "COMPLETED", + "startTime": 1556906974.781 + } + ], + "artifacts": { + "location": "arn:aws:s3:::artifacts-override/my-demo-project", + "encryptionDisabled": false, + "overrideArtifactName": true + }, + "buildComplete": true, + "buildStatus": "STOPPED", + "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", + "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", + "queuedTimeoutInMinutes": 5, + "timeoutInMinutes": 60, + "environment": { + "type": "LINUX_CONTAINER", + "environmentVariables": [], + "computeType": "BUILD_GENERAL1_MEDIUM", + "privilegedMode": false, + "image": "aws/codebuild/standard:1.0", + "imagePullCredentialsType": "CODEBUILD" + }, + "logs": { + "streamName": "1a2b3c4d-5678-90ab-cdef-11111EXAMPLE", + "deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logEvent:group=/aws/codebuild/my-demo-project;stream=1a2b3c4d-5678-90ab-cdef-11111EXAMPLE", + "groupName": "/aws/codebuild/my-demo-project" + }, + "arn": "arn:aws:codebuild:us-west-2:123456789012:build/my-demo-project:1a2b3c4d-5678-90ab-cdef-11111EXAMPLE" + } + } + +For more information, see `Stop a Build (AWS CLI) `_ in the *AWS CodeBuild User Guide*. diff --git a/bin/awscli/examples/codebuild/update-project.rst b/bin/awscli/examples/codebuild/update-project.rst new file mode 100755 index 00000000..aeee91a4 --- /dev/null +++ b/bin/awscli/examples/codebuild/update-project.rst @@ -0,0 +1,56 @@ +**To change an AWS CodeBuild build project's settings.** + +The following ``update-project`` example changes the settings of the specified CodeBuild build project named my-demo-project. :: + + aws codebuild update-project --name "my-demo-project" \ + --description "This project is updated" \ + --source "{\"type\": \"S3\",\"location\": \"codebuild-us-west-2-123456789012-input-bucket/my-source-2.zip\"}" \ + --artifacts {"\"type\": \"S3\",\"location\": \"codebuild-us-west-2-123456789012-output-bucket-2\""} \ + --environment "{\"type\": \"LINUX_CONTAINER\",\"image\": \"aws/codebuild/standard:1.0\",\"computeType\": \"BUILD_GENERAL1_MEDIUM\"}" \ + --service-role "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role" + +The output displays the updated settings. :: + + { + "project": { + "arn": "arn:aws:codebuild:us-west-2:123456789012:project/my-demo-project", + "environment": { + "privilegedMode": false, + "environmentVariables": [], + "type": "LINUX_CONTAINER", + "image": "aws/codebuild/standard:1.0", + "computeType": "BUILD_GENERAL1_MEDIUM", + "imagePullCredentialsType": "CODEBUILD" + }, + "queuedTimeoutInMinutes": 480, + "description": "This project is updated", + "artifacts": { + "packaging": "NONE", + "name": "my-demo-project", + "type": "S3", + "namespaceType": "NONE", + "encryptionDisabled": false, + "location": "codebuild-us-west-2-123456789012-output-bucket-2" + }, + "encryptionKey": "arn:aws:kms:us-west-2:123456789012:alias/aws/s3", + "badge": { + "badgeEnabled": false + }, + "serviceRole": "arn:aws:iam::123456789012:role/service-role/my-codebuild-service-role", + "lastModified": 1556840545.967, + "tags": [], + "timeoutInMinutes": 60, + "created": 1556839783.274, + "name": "my-demo-project", + "cache": { + "type": "NO_CACHE" + }, + "source": { + "type": "S3", + "insecureSsl": false, + "location": "codebuild-us-west-2-123456789012-input-bucket/my-source-2.zip" + } + } + } + +For more information, see `Change a Build Project's Settings (AWS CLI) `_ in the *AWS CodeBuild User Guide* diff --git a/bin/awscli/examples/codebuild/update-webhook.rst b/bin/awscli/examples/codebuild/update-webhook.rst new file mode 100755 index 00000000..ff3db761 --- /dev/null +++ b/bin/awscli/examples/codebuild/update-webhook.rst @@ -0,0 +1,47 @@ +**To update the webhook for an AWS CodeBuild project** + +The following ``update-webhook`` example updates a webhook for the specified CodeBuild project with two filter groups. The ``--rotate-secret`` parameter specifies that GitHub rotate the project's secret key every time a code change triggers a build. The first filter group specifies pull requests that are created, updated, or reopened on branches with Git reference names that match the regular expression ``^refs/heads/master$`` and head references that match ``^refs/heads/myBranch$``. The second filter group specifies push requests on branches with Git reference names that do not match the regular expression ``^refs/heads/myBranch$``. :: + + aws codebuild update-webhook \ + --project-name Project2 \ + --rotate-secret \ + --filter-groups "[[{\"type\":\"EVENT\",\"pattern\":\"PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED\"},{\"type\":\"HEAD_REF\",\"pattern\":\"^refs/heads/myBranch$\",\"excludeMatchedPattern\":true},{\"type\":\"BASE_REF\",\"pattern\":\"^refs/heads/master$\",\"excludeMatchedPattern\":true}],[{\"type\":\"EVENT\",\"pattern\":\"PUSH\"},{\"type\":\"HEAD_REF\",\"pattern\":\"^refs/heads/myBranch$\",\"excludeMatchedPattern\":true}]]" + +Output:: + + { + "webhook": { + "filterGroups": [ + [ + { + "pattern": "PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED", + "type": "EVENT" + }, + { + "excludeMatchedPattern": true, + "pattern": "refs/heads/myBranch$", + "type": "HEAD_REF" + }, + { + "excludeMatchedPattern": true, + "pattern": "refs/heads/master$", + "type": "BASE_REF" + } + ], + [ + { + "pattern": "PUSH", + "type": "EVENT" + }, + { + "excludeMatchedPattern": true, + "pattern": "refs/heads/myBranch$", + "type": "HEAD_REF" + } + ] + ], + "lastModifiedSecret": 1556312220.133 + } + } + +For more information, see `Change a Build Project's Settings (AWS CLI) `_ in the *AWS CodeBuild User Guide* diff --git a/bin/awscli/examples/codecommit/create-commit.rst b/bin/awscli/examples/codecommit/create-commit.rst new file mode 100755 index 00000000..61236319 --- /dev/null +++ b/bin/awscli/examples/codecommit/create-commit.rst @@ -0,0 +1,25 @@ +**To create a commit** + +The following ``create-commit`` example demonstrates how to create an initial commit for a repository that adds a ``readme.md`` file to a repository named ``MyDemoRepo`` in the ``master`` branch. :: + + aws codecommit create-commit --repository-name MyDemoRepo --branch-name master --put-files "filePath=readme.md,fileContent='Welcome to our team repository.'" + +Output:: + + { + "filesAdded": [ + { + "blobId": "5e1c309d-EXAMPLE", + "absolutePath": "readme.md", + "fileMode": "NORMAL" + } + ], + "commitId": "4df8b524-EXAMPLE", + "treeId": "55b57003-EXAMPLE", + "filesDeleted": [], + "filesUpdated": [] + } + +For more information, see `Create a Commit in AWS CodeCommit`_ in the *AWS CodeCommit User Guide*. + +.. _`Create a Commit in AWS CodeCommit`: https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-commit.html#how-to-create-commit-cli \ No newline at end of file diff --git a/bin/awscli/examples/codecommit/create-pull-request.rst b/bin/awscli/examples/codecommit/create-pull-request.rst index b3b5b2b4..311d342c 100644 --- a/bin/awscli/examples/codecommit/create-pull-request.rst +++ b/bin/awscli/examples/codecommit/create-pull-request.rst @@ -1,35 +1,36 @@ **To create a pull request** -This example demonstrates how to create a pull request named 'My Pull Request' with a description of 'Please review these changes by Tuesday' that targets the 'MyNewBranch' source branch and is to be merged to the default branch 'master' in an AWS CodeCommit repository named 'MyDemoRepo':: +The following ``create-pull-request`` example creates a pull request named 'My Pull Request' with a description of 'Please review these changes by Tuesday' that targets the 'MyNewBranch' source branch and is to be merged to the default branch 'master' in an AWS CodeCommit repository named 'MyDemoRepo'. :: - -Command:: - - aws codecommit create-pull-request --title "My Pull Request" --description "Please review these changes by Tuesday" --client-request-token 123Example --targets repositoryName=MyDemoRepo,sourceReference=MyNewBranch + aws codecommit create-pull-request \ + --title "My Pull Request" \ + --description "Please review these changes by Tuesday" \ + --client-request-token 123Example \ + --targets repositoryName=MyDemoRepo,sourceReference=MyNewBranch Output:: - { - "pullRequest": { - "authorArn": "arn:aws:iam::111111111111:user/Jane_Doe", - "clientRequestToken": "123Example", - "creationDate": 1508962823.285, - "description": "Please review these changes by Tuesday", - "lastActivityDate": 1508962823.285, - "pullRequestId": "42", - "pullRequestStatus": "OPEN", - "pullRequestTargets": [ - { - "destinationCommit": "5d036259EXAMPLE", - "destinationReference": "refs/heads/master", - "mergeMetadata": { - "isMerged": false, - }, - "repositoryName": "MyDemoRepo", - "sourceCommit": "317f8570EXAMPLE", - "sourceReference": "refs/heads/MyNewBranch" - } - ], - "title": "My Pull Request" + { + "pullRequest": { + "authorArn": "arn:aws:iam::111111111111:user/Jane_Doe", + "clientRequestToken": "123Example", + "creationDate": 1508962823.285, + "description": "Please review these changes by Tuesday", + "lastActivityDate": 1508962823.285, + "pullRequestId": "42", + "pullRequestStatus": "OPEN", + "pullRequestTargets": [ + { + "destinationCommit": "5d036259EXAMPLE", + "destinationReference": "refs/heads/master", + "mergeMetadata": { + "isMerged": false, + }, + "repositoryName": "MyDemoRepo", + "sourceCommit": "317f8570EXAMPLE", + "sourceReference": "refs/heads/MyNewBranch" + } + ], + "title": "My Pull Request" + } } - } \ No newline at end of file diff --git a/bin/awscli/examples/codecommit/credential-helper.rst b/bin/awscli/examples/codecommit/credential-helper.rst new file mode 100755 index 00000000..017d93ab --- /dev/null +++ b/bin/awscli/examples/codecommit/credential-helper.rst @@ -0,0 +1,18 @@ +**To set up the credential helper included in the AWS CLI with AWS CodeCommit** + +The ``credential-helper`` utility is not designed to be called directly from the AWS CLI. Instead it is intended to be used as a parameter with the ``git config`` command to set up your local computer. It enables Git to use HTTPS and a cryptographically signed version of your IAM user credentials or Amazon EC2 instance role whenever Git needs to authenticate with AWS to interact with CodeCommit repositories. :: + + git config --global credential.helper '!aws codecommit credential-helper $@' + git config --global credential.UseHttpPath true + +Output:: + + [credential] + helper = !aws codecommit credential-helper $@ + UseHttpPath = true + +For more information, see `Setting up for AWS CodeCommit Using Other Methods`_ in the *AWS CodeCommit User Guide*. Review the content carefully, and then follow the procedures in one of the following topics: `For HTTPS Connections on Linux, macOS, or Unix`_ or `For HTTPS Connections on Windows`_ in the *AWS CodeCommit User Guide*. + +.. _`Setting up for AWS CodeCommit Using Other Methods`: https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up.html?shortFooter=true#setting-up-other +.. _`For HTTPS Connections on Linux, macOS, or Unix`: https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-https-unixes.html +.. _`For HTTPS Connections on Windows`: https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-https-windows.html \ No newline at end of file diff --git a/bin/awscli/examples/codecommit/delete-file.rst b/bin/awscli/examples/codecommit/delete-file.rst new file mode 100755 index 00000000..5fdad2f7 --- /dev/null +++ b/bin/awscli/examples/codecommit/delete-file.rst @@ -0,0 +1,18 @@ +**To delete a file** + +The following ``delete-file`` example demonstrates how to delete a file named ``README.md`` from a branch named ``master`` with a most recent commit ID of ``c5709475EXAMPLE`` in a repository named ``MyDemoRepo``. :: + + aws codecommit delete-file --repository-name MyDemoRepo --branch-name master --file-path README.md --parent-commit-id c5709475EXAMPLE + +Output:: + + { + "blobId":"559b44fEXAMPLE", + "commitId":"353cf655EXAMPLE", + "filePath":"README.md", + "treeId":"6bc824cEXAMPLE" + } + +For more information, see `Edit or Delete a File in AWS CodeCommit`_ in the *AWS CodeCommit API Reference* guide. + +.. _`Edit or Delete a File in AWS CodeCommit`: https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-edit-file.html?shortFooter=true#how-to-edit-file-cli \ No newline at end of file diff --git a/bin/awscli/examples/codecommit/describe-pull-request-events.rst b/bin/awscli/examples/codecommit/describe-pull-request-events.rst index c93c5111..7297bc08 100644 --- a/bin/awscli/examples/codecommit/describe-pull-request-events.rst +++ b/bin/awscli/examples/codecommit/describe-pull-request-events.rst @@ -1,29 +1,27 @@ **To view events in a pull request** -This example demonstrates how to view the events for a pull request with the ID of '8':: +The following ``describe-pull-request-events`` example retrieves the events for a pull request with the ID of '8'. :: -Command:: - - aws codecommit describe-pull-request-events --pull-request-id 8 + aws codecommit describe-pull-request-events --pull-request-id 8 Output:: - { - "pullRequestEvents": [ - { - "pullRequestId": "8", - "pullRequestEventType": "PULL_REQUEST_CREATED", - "eventDate": 1510341779.53, - "actor": "arn:aws:iam::111111111111:user/Zhang_Wei" - }, - { - "pullRequestStatusChangedEventMetadata": { - "pullRequestStatus": "CLOSED" + { + "pullRequestEvents": [ + { + "pullRequestId": "8", + "pullRequestEventType": "PULL_REQUEST_CREATED", + "eventDate": 1510341779.53, + "actor": "arn:aws:iam::111111111111:user/Zhang_Wei" }, - "pullRequestId": "8", - "pullRequestEventType": "PULL_REQUEST_STATUS_CHANGED", - "eventDate": 1510341930.72, - "actor": "arn:aws:iam::111111111111:user/Jane_Doe" - } - ] - } \ No newline at end of file + { + "pullRequestStatusChangedEventMetadata": { + "pullRequestStatus": "CLOSED" + }, + "pullRequestId": "8", + "pullRequestEventType": "PULL_REQUEST_STATUS_CHANGED", + "eventDate": 1510341930.72, + "actor": "arn:aws:iam::111111111111:user/Jane_Doe" + } + ] + } diff --git a/bin/awscli/examples/codecommit/get-blob.rst b/bin/awscli/examples/codecommit/get-blob.rst index 826353aa..6588a0a0 100644 --- a/bin/awscli/examples/codecommit/get-blob.rst +++ b/bin/awscli/examples/codecommit/get-blob.rst @@ -1,14 +1,11 @@ **To view information about a Git blob object** -This example demonstrates how to view information about a Git blob with the ID of '2eb4af3bEXAMPLE' in an AWS CodeCommit repository named 'MyDemoRepo':: +The following ``get-blob`` example retrieves information about a Git blob with the ID of '2eb4af3bEXAMPLE' in an AWS CodeCommit repository named 'MyDemoRepo'. :: - -Command:: - - aws codecommit get-blob --repository-name MyDemoRepo --blob-id 2eb4af3bEXAMPLE + aws codecommit get-blob --repository-name MyDemoRepo --blob-id 2eb4af3bEXAMPLE Output:: - { - "content": "QSBCaW5hcnkgTGFyToEXAMPLE=" - } \ No newline at end of file + { + "content": "QSBCaW5hcnkgTGFyToEXAMPLE=" + } diff --git a/bin/awscli/examples/codecommit/get-comments-for-pull-request.rst b/bin/awscli/examples/codecommit/get-comments-for-pull-request.rst index 0ba27e5a..0821e099 100644 --- a/bin/awscli/examples/codecommit/get-comments-for-pull-request.rst +++ b/bin/awscli/examples/codecommit/get-comments-for-pull-request.rst @@ -1,49 +1,50 @@ **To view comments for a pull request** -This example demonstrates how to view comments for a pull request in a repository named 'MyDemoRepo':: +This example demonstrates how to view comments for a pull request in a repository named 'MyDemoRepo'. :: -Command:: - - aws codecommit get-comments-for-pull-request --repository-name MyDemoRepo --before-commit-ID 317f8570EXAMPLE --after-commit-id 5d036259EXAMPLE + aws codecommit get-comments-for-pull-request \ + --repository-name MyDemoRepo \ + --before-commit-ID 317f8570EXAMPLE \ + --after-commit-id 5d036259EXAMPLE Output:: - { - "commentsForPullRequestData": [ - { - "afterBlobId": "1f330709EXAMPLE", - "afterCommitId": "5d036259EXAMPLE", - "beforeBlobId": "80906a4cEXAMPLE", - "beforeCommitId": "317f8570EXAMPLE", - "comments": [ + { + "commentsForPullRequestData": [ { - "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", - "clientRequestToken": "", - "commentId": "abcd1234EXAMPLEb5678efgh", - "content": "These don't appear to be used anywhere. Can we remove them?", - "creationDate": 1508369622.123, - "deleted": false, - "lastModifiedDate": 1508369622.123 - }, - { - "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", - "clientRequestToken": "", - "commentId": "442b498bEXAMPLE5756813", - "content": "Good catch. I'll remove them.", - "creationDate": 1508369829.104, - "deleted": false, - "commentId": "abcd1234EXAMPLEb5678efgh", - "lastModifiedDate": 150836912.273 - } - ], - "location": { - "filePath": "ahs_count.py", - "filePosition": 367, - "relativeFileVersion": "AFTER" - }, - "repositoryName": "MyDemoRepo", - "pullRequestId": "42" - } - ], - "nextToken": "exampleToken" - } \ No newline at end of file + "afterBlobId": "1f330709EXAMPLE", + "afterCommitId": "5d036259EXAMPLE", + "beforeBlobId": "80906a4cEXAMPLE", + "beforeCommitId": "317f8570EXAMPLE", + "comments": [ + { + "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", + "clientRequestToken": "", + "commentId": "abcd1234EXAMPLEb5678efgh", + "content": "These don't appear to be used anywhere. Can we remove them?", + "creationDate": 1508369622.123, + "deleted": false, + "lastModifiedDate": 1508369622.123 + }, + { + "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", + "clientRequestToken": "", + "commentId": "442b498bEXAMPLE5756813", + "content": "Good catch. I'll remove them.", + "creationDate": 1508369829.104, + "deleted": false, + "commentId": "abcd1234EXAMPLEb5678efgh", + "lastModifiedDate": 150836912.273 + } + ], + "location": { + "filePath": "ahs_count.py", + "filePosition": 367, + "relativeFileVersion": "AFTER" + }, + "repositoryName": "MyDemoRepo", + "pullRequestId": "42" + } + ], + "nextToken": "exampleToken" + } diff --git a/bin/awscli/examples/codecommit/get-file.rst b/bin/awscli/examples/codecommit/get-file.rst new file mode 100755 index 00000000..8fb5d47e --- /dev/null +++ b/bin/awscli/examples/codecommit/get-file.rst @@ -0,0 +1,20 @@ +**To get the base-64 encoded contents of a file in an AWS CodeCommit repository** + +The following ``get-file`` example demonstrates how to get the base-64 encoded contents of a file named ``README.md`` from a branch named ``master`` in a repository named ``MyDemoRepo``. :: + + aws codecommit get-file --repository-name MyDemoRepo --commit-specifier master --file-path README.md + +Output:: + + { + "blobId":"559b44fEXAMPLE", + "commitId":"c5709475EXAMPLE", + "fileContent":"IyBQaHVzEXAMPLE", + "filePath":"README.md", + "fileMode":"NORMAL", + "fileSize":1563 + } + +For more information, see `GetFile`_ in the *AWS CodeCommit API Reference* guide. + +.. _`GetFile`: https://docs.aws.amazon.com/codecommit/latest/APIReference/API_GetFile.html diff --git a/bin/awscli/examples/codecommit/get-folder.rst b/bin/awscli/examples/codecommit/get-folder.rst new file mode 100755 index 00000000..011992d1 --- /dev/null +++ b/bin/awscli/examples/codecommit/get-folder.rst @@ -0,0 +1,63 @@ +**To get the contents of a folder in an AWS CodeCommit repository** + +The following ``get-folder`` example demonstrates how to get the contents of a top-level folder from a repository named ``MyDemoRepo``. :: + + aws codecommit get-folder --repository-name MyDemoRepo --folder-path "" + +Output:: + + { + "commitId":"c5709475EXAMPLE", + "files":[ + { + "absolutePath":".gitignore", + "blobId":"74094e8bEXAMPLE", + "fileMode":"NORMAL", + "relativePath":".gitignore" + }, + { + "absolutePath":"Gemfile", + "blobId":"9ceb72f6EXAMPLE", + "fileMode":"NORMAL", + "relativePath":"Gemfile" + }, + { + "absolutePath":"Gemfile.lock", + "blobId":"795c4a2aEXAMPLE", + "fileMode":"NORMAL", + "relativePath":"Gemfile.lock" + }, + { + "absolutePath":"LICENSE.txt", + "blobId":"0c7932c8EXAMPLE", + "fileMode":"NORMAL", + "relativePath":"LICENSE.txt" + }, + { + "absolutePath":"README.md", + "blobId":"559b44feEXAMPLE", + "fileMode":"NORMAL", + "relativePath":"README.md" + } + ], + "folderPath":"", + "subFolders":[ + { + "absolutePath":"public", + "relativePath":"public", + "treeId":"d5e92ae3aEXAMPLE" + }, + { + "absolutePath":"tmp", + "relativePath":"tmp", + "treeId":"d564d0bcEXAMPLE" + } + ], + "subModules":[], + "symbolicLinks":[], + "treeId":"7b3c4dadEXAMPLE" + } + +For more information, see `GetFolder`_ in the *AWS CodeCommit API Reference* guide. + +.. _`GetFolder`: https://docs.aws.amazon.com/codecommit/latest/APIReference/API_GetFolder.html diff --git a/bin/awscli/examples/codecommit/get-merge-conflicts.rst b/bin/awscli/examples/codecommit/get-merge-conflicts.rst index 612d3b2c..7d16cd4f 100644 --- a/bin/awscli/examples/codecommit/get-merge-conflicts.rst +++ b/bin/awscli/examples/codecommit/get-merge-conflicts.rst @@ -1,15 +1,17 @@ **To view whether there are any merge conflicts for a pull request** -This example demonstrates how to view whether there are any merge conflicts between the tip of a source branch named 'my-feature-branch' and a destination branch named 'master' in a repository named 'MyDemoRepo':: +The following ``get-merge-conflicts`` example displays whether there are any merge conflicts between the tip of a source branch named 'my-feature-branch' and a destination branch named 'master' in a repository named 'MyDemoRepo'. :: -Command:: - - aws codecommit get-merge-conflicts --repository-name MyDemoRepo --source-commit-specifier my-feature-branch --destination-commit-specifier master --merge-option FAST_FORWARD_MERGE + aws codecommit get-merge-conflicts \ + --repository-name MyDemoRepo \ + --source-commit-specifier my-feature-branch \ + --destination-commit-specifier master \ + --merge-option FAST_FORWARD_MERGE Output:: - { - "destinationCommitId": "fac04518EXAMPLE", - "mergeable": false, - "sourceCommitId": "16d097f03EXAMPLE" - } \ No newline at end of file + { + "destinationCommitId": "fac04518EXAMPLE", + "mergeable": false, + "sourceCommitId": "16d097f03EXAMPLE" + } diff --git a/bin/awscli/examples/codecommit/post-comment-for-pull-request.rst b/bin/awscli/examples/codecommit/post-comment-for-pull-request.rst index c07a9675..376cc46e 100644 --- a/bin/awscli/examples/codecommit/post-comment-for-pull-request.rst +++ b/bin/awscli/examples/codecommit/post-comment-for-pull-request.rst @@ -1,31 +1,38 @@ **To add a comment to a pull request** -This example demonstrates how to add the comment '"These don't appear to be used anywhere. Can we remove them?"' on the change to the 'ahs_count.py' file in a pull request with the ID of '47' in a repository named 'MyDemoRepo':: +The following ``post-comment-for-pull-request`` example adds the comment "These don't appear to be used anywhere. Can we remove them?" on the change to the ``ahs_count.py`` file in a pull request with the ID of '47' in a repository named 'MyDemoRepo'. :: - aws codecommit post-comment-for-pull-request --pull-request-id "47" --repository-name MyDemoRepo --before-commit-id 317f8570EXAMPLE --after-commit-id 5d036259EXAMPLE --client-request-token 123Example --content ""These don't appear to be used anywhere. Can we remove them?"" --location filePath=ahs_count.py,filePosition=367,relativeFileVersion=AFTER + aws codecommit post-comment-for-pull-request \ + --pull-request-id "47" \ + --repository-name MyDemoRepo \ + --before-commit-id 317f8570EXAMPLE \ + --after-commit-id 5d036259EXAMPLE \ + --client-request-token 123Example \ + --content "These don't appear to be used anywhere. Can we remove them?" \ + --location filePath=ahs_count.py,filePosition=367,relativeFileVersion=AFTER Output:: - { + { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "5d036259EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "317f8570EXAMPLE", "comment": { - "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", - "clientRequestToken": "123Example", - "commentId": "abcd1234EXAMPLEb5678efgh", - "content": "These don't appear to be used anywhere. Can we remove them?", - "creationDate": 1508369622.123, - "deleted": false, - "CommentId": "", - "lastModifiedDate": 1508369622.123 - } - "location": { - "filePath": "ahs_count.py", - "filePosition": 367, - "relativeFileVersion": "AFTER" + "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", + "clientRequestToken": "123Example", + "commentId": "abcd1234EXAMPLEb5678efgh", + "content": "These don't appear to be used anywhere. Can we remove them?", + "creationDate": 1508369622.123, + "deleted": false, + "CommentId": "", + "lastModifiedDate": 1508369622.123 + }, + "location": { + "filePath": "ahs_count.py", + "filePosition": 367, + "relativeFileVersion": "AFTER" }, "repositoryName": "MyDemoRepo", "pullRequestId": "47" - } \ No newline at end of file + } diff --git a/bin/awscli/examples/codecommit/put-file.rst b/bin/awscli/examples/codecommit/put-file.rst index c0fa8a49..ff9c8a41 100644 --- a/bin/awscli/examples/codecommit/put-file.rst +++ b/bin/awscli/examples/codecommit/put-file.rst @@ -1,17 +1,21 @@ **To add a file to a repository** -This example demonstrates how to add a file named 'ExampleSolution.py' to a repository named 'MyDemoRepo' to a branch named 'feature-randomizationfeature' whose most -recent commit has an ID of '4c925148EXAMPLE':: +The following ``put-file`` example adds a file named 'ExampleSolution.py' to a repository named 'MyDemoRepo' to a branch named 'feature-randomizationfeature' whose most recent commit has an ID of '4c925148EXAMPLE'. :: - -Command:: - - aws codecommit put-file --repository-name MyDemoRepo --branch-name feature-randomizationfeature --file-content file://MyDirectory/ExampleSolution.py --file-path /solutions/ExampleSolution.py --parent-commit-id 4c925148EXAMPLE --name "Maria Garcia" --email "maria_garcia@example.com" --commit-message "I added a third randomization routine." + aws codecommit put-file \ + --repository-name MyDemoRepo \ + --branch-name feature-randomizationfeature \ + --file-content file://MyDirectory/ExampleSolution.py \ + --file-path /solutions/ExampleSolution.py \ + --parent-commit-id 4c925148EXAMPLE \ + --name "Maria Garcia" \ + --email "maria_garcia@example.com" \ + --commit-message "I added a third randomization routine." Output:: - { - "blobId": "2eb4af3bEXAMPLE", - "commitId": "317f8570EXAMPLE", - "treeId": "347a3408EXAMPLE" - } + { + "blobId": "2eb4af3bEXAMPLE", + "commitId": "317f8570EXAMPLE", + "treeId": "347a3408EXAMPLE" + } diff --git a/bin/awscli/examples/codepipeline/create-custom-action-type.rst b/bin/awscli/examples/codepipeline/create-custom-action-type.rst index c3ced9cc..321f7692 100644 --- a/bin/awscli/examples/codepipeline/create-custom-action-type.rst +++ b/bin/awscli/examples/codepipeline/create-custom-action-type.rst @@ -1,42 +1,38 @@ **To create a custom action** -This example creates a custom action for AWS CodePipeline using an already-created JSON file (here named MyCustomAction.json) that contains the structure of the custom action. For more information about the requirements for creating a custom action, including the structure of the file, see the AWS CodePipeline User Guide. +This example creates a custom action for AWS CodePipeline using an already-created JSON file (here named MyCustomAction.json) that contains the structure of the custom action. For more information about the requirements for creating a custom action, including the structure of the file, see the AWS CodePipeline User Guide. :: -Command:: - - aws codepipeline create-custom-action-type --cli-input-json file://MyCustomAction.json - -JSON file sample contents:: + aws codepipeline create-custom-action-type --cli-input-json file://MyCustomAction.json - { - "category": "Build", - "provider": "MyJenkinsProviderName", - "version": "1", - "settings": { - "entityUrlTemplate": "https://192.0.2.4/job/{Config:ProjectName}/", - "executionUrlTemplate": "https://192.0.2.4/job/{Config:ProjectName}/lastSuccessfulBuild/{ExternalExecutionId}/" - }, - "configurationProperties": [ - { - "name": "MyJenkinsExampleBuildProject", - "required": true, - "key": true, - "secret": false, - "queryable": false, - "description": "The name of the build project must be provided when this action is added to the pipeline.", - "type": "String" +Contents of JSON file ``MyCustomAction.json``:: + + { + "category": "Build", + "provider": "MyJenkinsProviderName", + "version": "1", + "settings": { + "entityUrlTemplate": "https://192.0.2.4/job/{Config:ProjectName}/", + "executionUrlTemplate": "https://192.0.2.4/job/{Config:ProjectName}/lastSuccessfulBuild/{ExternalExecutionId}/" + }, + "configurationProperties": [ + { + "name": "MyJenkinsExampleBuildProject", + "required": true, + "key": true, + "secret": false, + "queryable": false, + "description": "The name of the build project must be provided when this action is added to the pipeline.", + "type": "String" + } + ], + "inputArtifactDetails": { + "maximumCount": 1, + "minimumCount": 0 + }, + "outputArtifactDetails": { + "maximumCount": 1, + "minimumCount": 0 } - ], - "inputArtifactDetails": { - "maximumCount": 1, - "minimumCount": 0 - }, - "outputArtifactDetails": { - "maximumCount": 1, - "minimumCount": 0 } -} - -Output:: - This command returns the structure of the custom action. \ No newline at end of file +This command returns the structure of the custom action. diff --git a/bin/awscli/examples/cognito-identity/create-identity-pool.rst b/bin/awscli/examples/cognito-identity/create-identity-pool.rst new file mode 100644 index 00000000..2cf19bf8 --- /dev/null +++ b/bin/awscli/examples/cognito-identity/create-identity-pool.rst @@ -0,0 +1,24 @@ +**To create an identity pool with Cognito identity pool provider** + +This example creates an identity pool named MyIdentityPool. It has a Cognito identity pool provider. +Unauthenticated identities are not allowed. + +Command:: + + aws cognito-identity create-identity-pool --identity-pool-name MyIdentityPool --no-allow-unauthenticated-identities --cognito-identity-providers ProviderName="cognito-idp.us-west-2.amazonaws.com/us-west-2_aaaaaaaaa",ClientId="3n4b5urk1ft4fl3mg5e62d9ado",ServerSideTokenCheck=false + +Output:: + + { + "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", + "IdentityPoolName": "MyIdentityPool", + "AllowUnauthenticatedIdentities": false, + "CognitoIdentityProviders": [ + { + "ProviderName": "cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111", + "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado", + "ServerSideTokenCheck": false + } + ] + } + diff --git a/bin/awscli/examples/cognito-identity/delete-identities.rst b/bin/awscli/examples/cognito-identity/delete-identities.rst new file mode 100644 index 00000000..d3f0b0af --- /dev/null +++ b/bin/awscli/examples/cognito-identity/delete-identities.rst @@ -0,0 +1,13 @@ +**To delete identity pool** + +This example deletes an identity ppol. + +Command:: + + aws cognito-identity delete-identity-pool --identity-ids-to-delete "us-west-2:11111111-1111-1111-1111-111111111111" + +Output:: + + { + "UnprocessedIdentityIds": [] + } diff --git a/bin/awscli/examples/cognito-identity/delete-identity-pool.rst b/bin/awscli/examples/cognito-identity/delete-identity-pool.rst new file mode 100644 index 00000000..8312fc10 --- /dev/null +++ b/bin/awscli/examples/cognito-identity/delete-identity-pool.rst @@ -0,0 +1,8 @@ +**To delete identity pool** + +This example deletes an identity ppol. + +Command:: + + aws cognito-identity delete-identity-pool --identity-ids-to-delete "us-west-2:11111111-1111-1111-1111-111111111111" + diff --git a/bin/awscli/examples/cognito-identity/describe-identity-pool.rst b/bin/awscli/examples/cognito-identity/describe-identity-pool.rst new file mode 100644 index 00000000..2f96b4dc --- /dev/null +++ b/bin/awscli/examples/cognito-identity/describe-identity-pool.rst @@ -0,0 +1,22 @@ +**To describe an identity pool** + +This example describes an identity pool. + +Command:: + + aws cognito-identity describe-identity-pool --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" + +Output:: + + { + "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", + "IdentityPoolName": "MyIdentityPool", + "AllowUnauthenticatedIdentities": false, + "CognitoIdentityProviders": [ + { + "ProviderName": "cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111", + "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado", + "ServerSideTokenCheck": false + } + ] + } diff --git a/bin/awscli/examples/cognito-identity/get-identity-pool-roles.rst b/bin/awscli/examples/cognito-identity/get-identity-pool-roles.rst new file mode 100644 index 00000000..0f8b1887 --- /dev/null +++ b/bin/awscli/examples/cognito-identity/get-identity-pool-roles.rst @@ -0,0 +1,17 @@ +**To get identity pool roles** + +This example gets identity pool roles. + +Command:: + + aws cognito-identity get-identity-pool-roles --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" + +Output:: + + { + "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", + "Roles": { + "authenticated": "arn:aws:iam::111111111111:role/Cognito_MyIdentityPoolAuth_Role", + "unauthenticated": "arn:aws:iam::111111111111:role/Cognito_MyIdentityPoolUnauth_Role" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-identity/list-identity-pools.rst b/bin/awscli/examples/cognito-identity/list-identity-pools.rst new file mode 100644 index 00000000..d99a531c --- /dev/null +++ b/bin/awscli/examples/cognito-identity/list-identity-pools.rst @@ -0,0 +1,26 @@ +**To list identity pools** + +This example lists identity pools. There s a maximum of 20 identities listed. + +Command:: + + aws cognito-identity list-identity-pools --max-results 20 + +Output:: + + { + "IdentityPools": [ + { + "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", + "IdentityPoolName": "MyIdentityPool" + }, + { + "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", + "IdentityPoolName": "AnotherIdentityPool" + }, + { + "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", + "IdentityPoolName": "IdentityPoolRegionA" + } + ] + } diff --git a/bin/awscli/examples/cognito-identity/set-identity-pool-roles.rst b/bin/awscli/examples/cognito-identity/set-identity-pool-roles.rst new file mode 100644 index 00000000..afc23da9 --- /dev/null +++ b/bin/awscli/examples/cognito-identity/set-identity-pool-roles.rst @@ -0,0 +1,7 @@ +**To get identity pool roles** + +This example sets an identity pool role. + +Command:: + + aws cognito-identity set-identity-pool-roles --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" authenticated="arn:aws:iam::111111111111:role/Cognito_MyIdentityPoolAuth_Role" diff --git a/bin/awscli/examples/cognito-identity/update-identity-pool.rst b/bin/awscli/examples/cognito-identity/update-identity-pool.rst new file mode 100644 index 00000000..2ac50616 --- /dev/null +++ b/bin/awscli/examples/cognito-identity/update-identity-pool.rst @@ -0,0 +1,23 @@ +**To update an identity pool** + +This example updates an identity pool. It sets the name to MyIdentityPool. It adds Cognito as an identity provider. +It disallows unauthenticated identities. + +Command:: + + aws cognito-identity update-identity-pool --identity-pool-id "us-west-2:11111111-1111-1111-1111-111111111111" --identity-pool-name "MyIdentityPool" --no-allow-unauthenticated-identities --cognito-identity-providers ProviderName="cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111",ClientId="3n4b5urk1ft4fl3mg5e62d9ado",ServerSideTokenCheck=false + +Output:: + + { + "IdentityPoolId": "us-west-2:11111111-1111-1111-1111-111111111111", + "IdentityPoolName": "MyIdentityPool", + "AllowUnauthenticatedIdentities": false, + "CognitoIdentityProviders": [ + { + "ProviderName": "cognito-idp.us-west-2.amazonaws.com/us-west-2_111111111", + "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado", + "ServerSideTokenCheck": false + } + ] + } diff --git a/bin/awscli/examples/cognito-idp/add-custom-attributes.rst b/bin/awscli/examples/cognito-idp/add-custom-attributes.rst new file mode 100644 index 00000000..923612c4 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/add-custom-attributes.rst @@ -0,0 +1,8 @@ +**To add a custom attribute** + +This example adds a custom attribute CustomAttr1 to a user pool. It is a String type, +and requires a minimum of 1 character and a maximum of 15. It is not required. + +Command:: + + aws cognito-idp add-custom-attributes --user-pool-id us-west-2_aaaaaaaaa --custom-attributes Name="CustomAttr1",AttributeDataType="String",DeveloperOnlyAttribute=false,Required=false,StringAttributeConstraints="{MinLength=1,MaxLength=15}" diff --git a/bin/awscli/examples/cognito-idp/admim-disable-user.rst b/bin/awscli/examples/cognito-idp/admim-disable-user.rst new file mode 100644 index 00000000..57e8ec36 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admim-disable-user.rst @@ -0,0 +1,8 @@ +**To disable a user** + +This example disables user jane@example.com. + +Command:: + + aws cognito-idp admin-disable-user --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com + diff --git a/bin/awscli/examples/cognito-idp/admim-enable-user.rst b/bin/awscli/examples/cognito-idp/admim-enable-user.rst new file mode 100644 index 00000000..79bc468e --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admim-enable-user.rst @@ -0,0 +1,8 @@ +**To enable a user** + +This example enables username jane@example.com. + +Command:: + + aws cognito-idp admin-enable-user --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com + diff --git a/bin/awscli/examples/cognito-idp/admin-add-user-to-group.rst b/bin/awscli/examples/cognito-idp/admin-add-user-to-group.rst new file mode 100644 index 00000000..6fa23ad3 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-add-user-to-group.rst @@ -0,0 +1,8 @@ +**To add a user to a group** + +This example adds user Jane to group MyGroup. + +Command:: + + aws cognito-idp admin-add-user-to-group --user-pool-id us-west-2_aaaaaaaaa --username Jane --group-name MyGroup + diff --git a/bin/awscli/examples/cognito-idp/admin-confirm-sign-up.rst b/bin/awscli/examples/cognito-idp/admin-confirm-sign-up.rst new file mode 100644 index 00000000..dd0bb917 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-confirm-sign-up.rst @@ -0,0 +1,8 @@ +**To confirm user registration** + +This example confirms user jane@example.com. + +Command:: + + aws cognito-idp admin-confirm-sign-up --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com + diff --git a/bin/awscli/examples/cognito-idp/admin-create-user.rst b/bin/awscli/examples/cognito-idp/admin-create-user.rst new file mode 100644 index 00000000..1e069050 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-create-user.rst @@ -0,0 +1,35 @@ +**To create a user** + +This example creates username diego@example.com. An email address and phone number +are specified. + +Command:: + + aws cognito-idp admin-create-user --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --user-attributes=Name=email,Value=kermit2@somewhere.com,Name=phone_number,Value="+15555551212" --message-action SUPPRESS + +Output:: + + { + "User": { + "Username": "7325c1de-b05b-4f84-b321-9adc6e61f4a2", + "Enabled": true, + "UserStatus": "FORCE_CHANGE_PASSWORD", + "UserCreateDate": 1548099495.428, + "UserLastModifiedDate": 1548099495.428, + "Attributes": [ + { + "Name": "sub", + "Value": "7325c1de-b05b-4f84-b321-9adc6e61f4a2" + }, + { + "Name": "phone_number", + "Value": "+15555551212" + }, + { + "Name": "email", + "Value": "diego@example.com" + } + ] + } + } + diff --git a/bin/awscli/examples/cognito-idp/admin-delete-user-attributes.rst b/bin/awscli/examples/cognito-idp/admin-delete-user-attributes.rst new file mode 100644 index 00000000..d96fb176 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-delete-user-attributes.rst @@ -0,0 +1,8 @@ +**To delete a user attribute** + +This example deletes a custom attribute CustomAttr1 for user diego@example.com. + +Command:: + + aws cognito-idp admin-delete-user-attributes --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --user-attribute-names "custom:CustomAttr1" + diff --git a/bin/awscli/examples/cognito-idp/admin-delete-user.rst b/bin/awscli/examples/cognito-idp/admin-delete-user.rst new file mode 100644 index 00000000..ac0bbb36 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-delete-user.rst @@ -0,0 +1,8 @@ +**To delete a user** + +This example deletes a user. + +Command:: + + aws cognito-idp admin-delete-user --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com + diff --git a/bin/awscli/examples/cognito-idp/admin-forget-device.rst b/bin/awscli/examples/cognito-idp/admin-forget-device.rst new file mode 100644 index 00000000..f23c77d7 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-forget-device.rst @@ -0,0 +1,8 @@ +**To forget a device** + +This example forgets device for username jane@example.com + +Command:: + + aws cognito-idp admin-forget-device --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com --device-key us-west-2_abcd_1234-5678 + diff --git a/bin/awscli/examples/cognito-idp/admin-get-device.rst b/bin/awscli/examples/cognito-idp/admin-get-device.rst new file mode 100644 index 00000000..92fff255 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-get-device.rst @@ -0,0 +1,8 @@ +**To get a device** + +This example gets a device for username jane@example.com + +Command:: + + aws cognito-idp admin-get-device --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com --device-key us-west-2_abcd_1234-5678 + diff --git a/bin/awscli/examples/cognito-idp/admin-get-user.rst b/bin/awscli/examples/cognito-idp/admin-get-user.rst new file mode 100644 index 00000000..3de46a14 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-get-user.rst @@ -0,0 +1,39 @@ +**To get a user** + +This example gets information about username jane@example.com. + +Command:: + + aws cognito-idp admin-get-user --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com + +Output:: + + { + "Username": "4320de44-2322-4620-999b-5e2e1c8df013", + "Enabled": true, + "UserStatus": "FORCE_CHANGE_PASSWORD", + "UserCreateDate": 1548108509.537, + "UserAttributes": [ + { + "Name": "sub", + "Value": "4320de44-2322-4620-999b-5e2e1c8df013" + }, + { + "Name": "email_verified", + "Value": "true" + }, + { + "Name": "phone_number_verified", + "Value": "true" + }, + { + "Name": "phone_number", + "Value": "+01115551212" + }, + { + "Name": "email", + "Value": "jane@example.com" + } + ], + "UserLastModifiedDate": 1548108509.537 + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/admin-initiate-auth.rst b/bin/awscli/examples/cognito-idp/admin-initiate-auth.rst new file mode 100644 index 00000000..bdb01054 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-initiate-auth.rst @@ -0,0 +1,25 @@ +**To initiate authorization** + +This example initiates authorization using the ADMIN_NO_SRP_AUTH flow for username jane@example.com + +The client must have sign-in API for server-based authentication (ADMIN_NO_SRP_AUTH) enabled. + +Use the session information in the return value to call `admin-respond-to-auth-challenge`_. + +Command:: + + aws cognito-idp admin-initiate-auth --user-pool-id us-west-2_aaaaaaaaa --client-id 3n4b5urk1ft4fl3mg5e62d9ado --auth-flow ADMIN_NO_SRP_AUTH --auth-parameters USERNAME=jane@example.com,PASSWORD=password + +Output:: + + { + "ChallengeName": "NEW_PASSWORD_REQUIRED", + "Session": "SESSION", + "ChallengeParameters": { + "USER_ID_FOR_SRP": "84514837-dcbc-4af1-abff-f3c109334894", + "requiredAttributes": "[]", + "userAttributes": "{\"email_verified\":\"true\",\"phone_number_verified\":\"true\",\"phone_number\":\"+01xxx5550100\",\"email\":\"jane@example.com\"}" + } + } + +.. _`admin-respond-to-auth-challenge`: https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/admin-respond-to-auth-challenge.html \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/admin-list-devices.rst b/bin/awscli/examples/cognito-idp/admin-list-devices.rst new file mode 100644 index 00000000..2b710876 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-list-devices.rst @@ -0,0 +1,7 @@ +**To list devices for a user** + +This example lists devices for username jane@example.com. + +Command:: + + aws cognito-idp admin-list-devices --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com diff --git a/bin/awscli/examples/cognito-idp/admin-list-groups-for-user.rst b/bin/awscli/examples/cognito-idp/admin-list-groups-for-user.rst new file mode 100644 index 00000000..aa213497 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-list-groups-for-user.rst @@ -0,0 +1,23 @@ +**To list groups for a user** + +This example lists groups for username jane@example.com. + +Command:: + + aws cognito-idp admin-list-groups-for-user --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com + +Output:: + + { + "Groups": [ + { + "Description": "Sample group", + "Precedence": 1, + "LastModifiedDate": 1548097827.125, + "RoleArn": "arn:aws:iam::111111111111:role/SampleRole", + "GroupName": "SampleGroup", + "UserPoolId": "us-west-2_aaaaaaaaa", + "CreationDate": 1548097827.125 + } + ] + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/admin-list-user-auth-events.rst b/bin/awscli/examples/cognito-idp/admin-list-user-auth-events.rst new file mode 100644 index 00000000..eeff1edb --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-list-user-auth-events.rst @@ -0,0 +1,8 @@ +**To list authorization events for a user** + +This example lists authorization events for username diego@example.com. + +Command:: + + aws cognito-idp admin-list-user-auth-events --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com + diff --git a/bin/awscli/examples/cognito-idp/admin-remove-user-from-group.rst b/bin/awscli/examples/cognito-idp/admin-remove-user-from-group.rst new file mode 100644 index 00000000..4f41bf8b --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-remove-user-from-group.rst @@ -0,0 +1,7 @@ +**To remove a user from a group** + +This example removes jane@example.com from SampleGroup. + +Command:: + + aws cognito-idp admin-remove-user-from-group --user-pool-id us-west-2_aaaaaaaaa --username jane@example.com --group-name SampleGroup diff --git a/bin/awscli/examples/cognito-idp/admin-reset-user-password.rst b/bin/awscli/examples/cognito-idp/admin-reset-user-password.rst new file mode 100644 index 00000000..7732c674 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-reset-user-password.rst @@ -0,0 +1,7 @@ +**To reset a user password** + +This example resets the password for diego@example.com. + +Command:: + + aws cognito-idp admin-reset-user-password --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com diff --git a/bin/awscli/examples/cognito-idp/admin-set-user-mfa-preference.rst b/bin/awscli/examples/cognito-idp/admin-set-user-mfa-preference.rst new file mode 100644 index 00000000..7cbd28c4 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-set-user-mfa-preference.rst @@ -0,0 +1,8 @@ +**To set the user MFA preference** + +This example sets the SMS MFA preference for username diego@example.com. + +Command:: + + aws cognito-idp admin-set-user-mfa-preference --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --sms-mfa-settings Enabled=false,PreferredMfa=false + diff --git a/bin/awscli/examples/cognito-idp/admin-set-user-settings.rst b/bin/awscli/examples/cognito-idp/admin-set-user-settings.rst new file mode 100644 index 00000000..d5d7d7a3 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-set-user-settings.rst @@ -0,0 +1,8 @@ +**To set user settings** + +This example sets the MFA delivery preference for username diego@example.com to EMAIL. + +Command:: + + aws cognito-idp admin-set-user-settings --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --mfa-options DeliveryMedium=EMAIL + diff --git a/bin/awscli/examples/cognito-idp/admin-update-auth-event-feedback.rst b/bin/awscli/examples/cognito-idp/admin-update-auth-event-feedback.rst new file mode 100644 index 00000000..06065188 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-update-auth-event-feedback.rst @@ -0,0 +1,8 @@ +**To provide feedback for an authorization event** + +This example sets the feedback value for an authorization event identified by event-id to Valid. + +Command:: + + aws cognito-idp admin-update-auth-event-feedback --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --event-id c2c2cf89-c0d3-482d-aba6-99d78a5b0bfe --feedback-value Valid + diff --git a/bin/awscli/examples/cognito-idp/admin-update-device-status.rst b/bin/awscli/examples/cognito-idp/admin-update-device-status.rst new file mode 100644 index 00000000..7c009b69 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-update-device-status.rst @@ -0,0 +1,8 @@ +**To update device status** + +This example sets the device remembered status for the device identified by device-key to not_remembered. + +Command:: + + aws cognito-idp admin-update-device-status --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --device-key xxxx --device-remembered-status not_remembered + diff --git a/bin/awscli/examples/cognito-idp/admin-update-user-attributes.rst b/bin/awscli/examples/cognito-idp/admin-update-user-attributes.rst new file mode 100644 index 00000000..7626f6f5 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/admin-update-user-attributes.rst @@ -0,0 +1,8 @@ +**To update user attributes** + +This example updates a custom user attribute CustomAttr1 for user diego@example.com. + +Command:: + + aws cognito-idp admin-update-user-attributes --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com Name="custom:CustomAttr1",Value="Purple" + diff --git a/bin/awscli/examples/cognito-idp/change-password.rst b/bin/awscli/examples/cognito-idp/change-password.rst new file mode 100644 index 00000000..7c787e75 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/change-password.rst @@ -0,0 +1,7 @@ +**To change a password** + +This example changes a password. + +Command:: + + aws cognito-idp change-password --previous-password OldPassword --proposed-password NewPassword --access-token ACCESS_TOKEN diff --git a/bin/awscli/examples/cognito-idp/confirm-forgot-password.rst b/bin/awscli/examples/cognito-idp/confirm-forgot-password.rst new file mode 100644 index 00000000..93d8e717 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/confirm-forgot-password.rst @@ -0,0 +1,8 @@ +**To confirm a forgotten password** + +This example confirms a forgotten password for username diego@example.com. + +Command:: + + aws cognito-idp confirm-forgot-password --client-id 3n4b5urk1ft4fl3mg5e62d9ado --username=diego@example.com --password PASSWORD --confirmation-code CONF_CODE + diff --git a/bin/awscli/examples/cognito-idp/confirm-sign-up.rst b/bin/awscli/examples/cognito-idp/confirm-sign-up.rst new file mode 100644 index 00000000..08efe9fe --- /dev/null +++ b/bin/awscli/examples/cognito-idp/confirm-sign-up.rst @@ -0,0 +1,8 @@ +**To confirm sign-up** + +This example confirms sign-up for username diego@example.com. + +Command:: + + aws cognito-idp confirm-sign-up --client-id 3n4b5urk1ft4fl3mg5e62d9ado --username=diego@example.com --confirmation-code CONF_CODE + \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/create-group.rst b/bin/awscli/examples/cognito-idp/create-group.rst new file mode 100644 index 00000000..35e5c6ea --- /dev/null +++ b/bin/awscli/examples/cognito-idp/create-group.rst @@ -0,0 +1,41 @@ +**To create a group** + +This example creates a group with a description. + +Command:: + + aws cognito-idp create-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyNewGroup --description "New group." + +Output:: + + { + "Group": { + "GroupName": "MyNewGroup", + "UserPoolId": "us-west-2_aaaaaaaaa", + "Description": "New group.", + "LastModifiedDate": 1548270073.795, + "CreationDate": 1548270073.795 + } + } + +**To create a group with a role and precedence** + +This example creates a group with a description. It also includes a role and precedence. + +Command:: + + aws cognito-idp create-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyNewGroupWithRole --description "New group with a role." --role-arn arn:aws:iam::111111111111:role/MyNewGroupRole --precedence 2 + +Output:: + + { + "Group": { + "GroupName": "MyNewGroupWithRole", + "UserPoolId": "us-west-2_aaaaaaaaa", + "Description": "New group with a role.", + "RoleArn": "arn:aws:iam::111111111111:role/MyNewGroupRole", + "Precedence": 2, + "LastModifiedDate": 1548270211.761, + "CreationDate": 1548270211.761 + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/create-user-import-job.rst b/bin/awscli/examples/cognito-idp/create-user-import-job.rst new file mode 100644 index 00000000..46e66def --- /dev/null +++ b/bin/awscli/examples/cognito-idp/create-user-import-job.rst @@ -0,0 +1,35 @@ +**To create a user import job** + +This example creates a user import job named MyImportJob. + +For more information about importing users, see `Importing Users into User Pools From a CSV File`_. + +Command:: + + aws cognito-idp create-user-import-job --user-pool-id us-west-2_aaaaaaaaa --job-name MyImportJob --cloud-watch-logs-role-arn arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole + +Output:: + + { + "UserImportJob": { + "JobName": "MyImportJob", + "JobId": "import-qQ0DCt2fRh", + "UserPoolId": "us-west-2_aaaaaaaaa", + "PreSignedUrl": "PRE_SIGNED_URL", + "CreationDate": 1548271795.471, + "Status": "Created", + "CloudWatchLogsRoleArn": "arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole", + "ImportedUsers": 0, + "SkippedUsers": 0, + "FailedUsers": 0 + } + } + +Upload the .csv file with curl using the pre-signed URL: + +Command:: + + curl -v -T "PATH_TO_CSV_FILE" -H "x-amz-server-side-encryption:aws:kms" "PRE_SIGNED_URL" + + +.. _`Importing Users into User Pools From a CSV File`: https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-using-import-tool.html \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/create-user-pool-client.rst b/bin/awscli/examples/cognito-idp/create-user-pool-client.rst new file mode 100644 index 00000000..3d9129ae --- /dev/null +++ b/bin/awscli/examples/cognito-idp/create-user-pool-client.rst @@ -0,0 +1,26 @@ +**To create a user pool client** + +This example creates a new user pool client with two explicit authorization flows: USER_PASSWORD_AUTH and ADMIN_NO_SRP_AUTH. + +Command:: + + aws cognito-idp create-user-pool-client --user-pool-id us-west-2_aaaaaaaaa --client-name MyNewClient --no-generate-secret --explicit-auth-flows "USER_PASSWORD_AUTH" "ADMIN_NO_SRP_AUTH" + +Output:: + + { + "UserPoolClient": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "ClientName": "MyNewClient", + "ClientId": "6p3bs000no6a4ue1idruvd05ad", + "LastModifiedDate": 1548697449.497, + "CreationDate": 1548697449.497, + "RefreshTokenValidity": 30, + "ExplicitAuthFlows": [ + "USER_PASSWORD_AUTH", + "ADMIN_NO_SRP_AUTH" + ], + "AllowedOAuthFlowsUserPoolClient": false + } + } + diff --git a/bin/awscli/examples/cognito-idp/create-user-pool-domain.rst b/bin/awscli/examples/cognito-idp/create-user-pool-domain.rst new file mode 100644 index 00000000..77e6185c --- /dev/null +++ b/bin/awscli/examples/cognito-idp/create-user-pool-domain.rst @@ -0,0 +1,8 @@ +**To create a user pool domain** + +This example creates a new user pool domain. with two explicit authorization flows: USER_PASSWORD_AUTH and ADMIN_NO_SRP_AUTH. + +Command:: + + aws cognito-idp create-user-pool-domain --user-pool-id us-west-2_aaaaaaaaa --domain my-new-domain + diff --git a/bin/awscli/examples/cognito-idp/create-user-pool.rst b/bin/awscli/examples/cognito-idp/create-user-pool.rst new file mode 100644 index 00000000..ce41f20c --- /dev/null +++ b/bin/awscli/examples/cognito-idp/create-user-pool.rst @@ -0,0 +1,506 @@ +**To create a minimally configured user pool** + +This example creates a user pool named MyUserPool using default values. There are no required attributes +and no application clients. MFA and advanced security is disabled. + +Command:: + + aws cognito-idp create-user-pool --pool-name MyUserPool + +Output:: + + { + "UserPool": { + "SchemaAttributes": [ + { + "Name": "sub", + "StringAttributeConstraints": { + "MinLength": "1", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": true, + "AttributeDataType": "String", + "Mutable": false + }, + { + "Name": "name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "given_name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "family_name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "middle_name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "nickname", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "preferred_username", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "profile", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "picture", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "website", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "email", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "AttributeDataType": "Boolean", + "DeveloperOnlyAttribute": false, + "Required": false, + "Name": "email_verified", + "Mutable": true + }, + { + "Name": "gender", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "birthdate", + "StringAttributeConstraints": { + "MinLength": "10", + "MaxLength": "10" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "zoneinfo", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "locale", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "phone_number", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "AttributeDataType": "Boolean", + "DeveloperOnlyAttribute": false, + "Required": false, + "Name": "phone_number_verified", + "Mutable": true + }, + { + "Name": "address", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "updated_at", + "NumberAttributeConstraints": { + "MinValue": "0" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "Number", + "Mutable": true + } + ], + "MfaConfiguration": "OFF", + "Name": "MyUserPool", + "LastModifiedDate": 1547833345.777, + "AdminCreateUserConfig": { + "UnusedAccountValidityDays": 7, + "AllowAdminCreateUserOnly": false + }, + "EmailConfiguration": {}, + "Policies": { + "PasswordPolicy": { + "RequireLowercase": true, + "RequireSymbols": true, + "RequireNumbers": true, + "MinimumLength": 8, + "RequireUppercase": true + } + }, + "CreationDate": 1547833345.777, + "EstimatedNumberOfUsers": 0, + "Id": "us-west-2_aaaaaaaaa", + "LambdaConfig": {} + } + } + +**To create a user pool with two required attributes** + +This example creates a user pool MyUserPool. The pool is configured to accept +email as a username attribute. It also sets the email source address to a +validated address using Amazon Simple Email Service. + +Command:: + + aws cognito-idp create-user-pool --pool-name MyUserPool --username-attributes "email" --email-configuration=SourceArn="arn:aws:ses:us-east-1:111111111111:identity/jane@example.com",ReplyToEmailAddress="jane@example.com" + +Output:: + + { + "UserPool": { + "SchemaAttributes": [ + { + "Name": "sub", + "StringAttributeConstraints": { + "MinLength": "1", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": true, + "AttributeDataType": "String", + "Mutable": false + }, + { + "Name": "name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "given_name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "family_name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "middle_name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "nickname", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "preferred_username", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "profile", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "picture", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "website", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "email", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "AttributeDataType": "Boolean", + "DeveloperOnlyAttribute": false, + "Required": false, + "Name": "email_verified", + "Mutable": true + }, + { + "Name": "gender", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "birthdate", + "StringAttributeConstraints": { + "MinLength": "10", + "MaxLength": "10" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "zoneinfo", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "locale", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "phone_number", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "AttributeDataType": "Boolean", + "DeveloperOnlyAttribute": false, + "Required": false, + "Name": "phone_number_verified", + "Mutable": true + }, + { + "Name": "address", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "updated_at", + "NumberAttributeConstraints": { + "MinValue": "0" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "Number", + "Mutable": true + } + ], + "MfaConfiguration": "OFF", + "Name": "MyUserPool", + "LastModifiedDate": 1547837788.189, + "AdminCreateUserConfig": { + "UnusedAccountValidityDays": 7, + "AllowAdminCreateUserOnly": false + }, + "EmailConfiguration": { + "ReplyToEmailAddress": "jane@example.com", + "SourceArn": "arn:aws:ses:us-east-1:111111111111:identity/jane@example.com" + }, + "Policies": { + "PasswordPolicy": { + "RequireLowercase": true, + "RequireSymbols": true, + "RequireNumbers": true, + "MinimumLength": 8, + "RequireUppercase": true + } + }, + "UsernameAttributes": [ + "email" + ], + "CreationDate": 1547837788.189, + "EstimatedNumberOfUsers": 0, + "Id": "us-west-2_aaaaaaaaa", + "LambdaConfig": {} + } + } diff --git a/bin/awscli/examples/cognito-idp/delete-group.rst b/bin/awscli/examples/cognito-idp/delete-group.rst new file mode 100644 index 00000000..9b6d2911 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/delete-group.rst @@ -0,0 +1,8 @@ +**To delete a group** + +This example deletes a group. + +Command:: + + aws cognito-idp delete-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyGroupName + diff --git a/bin/awscli/examples/cognito-idp/delete-identity-provider.rst b/bin/awscli/examples/cognito-idp/delete-identity-provider.rst new file mode 100644 index 00000000..dd0d3383 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/delete-identity-provider.rst @@ -0,0 +1,8 @@ +**To delete an identity provider** + +This example deletes an identity provider. + +Command:: + + aws cognito-idp delete-identity-provider --user-pool-id us-west-2_aaaaaaaaa --provider-name Facebook + diff --git a/bin/awscli/examples/cognito-idp/delete-resource-server.rst b/bin/awscli/examples/cognito-idp/delete-resource-server.rst new file mode 100644 index 00000000..5498f504 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/delete-resource-server.rst @@ -0,0 +1,8 @@ +**To delete a resource server** + +This example deletes a resource server named weather.example.com. + +Command:: + + aws cognito-idp delete-resource-server --user-pool-id us-west-2_aaaaaaaaa --identifier weather.example.com + diff --git a/bin/awscli/examples/cognito-idp/delete-user-attributes.rst b/bin/awscli/examples/cognito-idp/delete-user-attributes.rst new file mode 100644 index 00000000..3856abc4 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/delete-user-attributes.rst @@ -0,0 +1,8 @@ +**To delete user attributes** + +This example deletes the user attribute "FAVORITE_ANIMAL". + +Command:: + + aws cognito-idp delete-user-attributes --access-token ACCESS_TOKEN --user-attribute-names "FAVORITE_ANIMAL" + diff --git a/bin/awscli/examples/cognito-idp/delete-user-pool-client.rst b/bin/awscli/examples/cognito-idp/delete-user-pool-client.rst new file mode 100644 index 00000000..331dab5b --- /dev/null +++ b/bin/awscli/examples/cognito-idp/delete-user-pool-client.rst @@ -0,0 +1,8 @@ +**To delete a user pool client** + +This example deletes a user pool client. + +Command:: + + aws cognito-idp delete-user-pool-client --user-pool-id us-west-2_aaaaaaaaa --client-id 38fjsnc484p94kpqsnet7mpld0 + diff --git a/bin/awscli/examples/cognito-idp/delete-user-pool-domain.rst b/bin/awscli/examples/cognito-idp/delete-user-pool-domain.rst new file mode 100644 index 00000000..edce2ce2 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/delete-user-pool-domain.rst @@ -0,0 +1,8 @@ +**To delete a user pool domain** + +This example deletes a user pool domain named my-domain. + +Command:: + + aws cognito-idp delete-user-pool --user-pool-id us-west-2_aaaaaaaaa --domain my-domain + diff --git a/bin/awscli/examples/cognito-idp/delete-user-pool.rst b/bin/awscli/examples/cognito-idp/delete-user-pool.rst new file mode 100644 index 00000000..c66dcf35 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/delete-user-pool.rst @@ -0,0 +1,8 @@ +**To delete a user pool** + +This example deletes a user pool using the user pool id, us-west-2_aaaaaaaaa. + +Command:: + + aws cognito-idp delete-user-pool --user-pool-id us-west-2_aaaaaaaaa + diff --git a/bin/awscli/examples/cognito-idp/delete-user.rst b/bin/awscli/examples/cognito-idp/delete-user.rst new file mode 100644 index 00000000..d00d5cb3 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/delete-user.rst @@ -0,0 +1,8 @@ +**To delete a user** + +This example deletes a user. + +Command:: + + aws cognito-idp delete-user --access-token ACCESS_TOKEN + diff --git a/bin/awscli/examples/cognito-idp/describe-identity-provider.rst b/bin/awscli/examples/cognito-idp/describe-identity-provider.rst new file mode 100644 index 00000000..21f5d94e --- /dev/null +++ b/bin/awscli/examples/cognito-idp/describe-identity-provider.rst @@ -0,0 +1,33 @@ +**To describe an identity provider** + +This example describes an identity provider named Facebook. + +Command:: + + aws cognito-idp describe-identity-provider --user-pool-id us-west-2_aaaaaaaaa --provider-name Facebook + +Output:: + + { + "IdentityProvider": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "ProviderName": "Facebook", + "ProviderType": "Facebook", + "ProviderDetails": { + "attributes_url": "https://graph.facebook.com/me?fields=", + "attributes_url_add_attributes": "true", + "authorize_scopes": myscope", + "authorize_url": "https://www.facebook.com/v2.9/dialog/oauth", + "client_id": "11111", + "client_secret": "11111", + "token_request_method": "GET", + "token_url": "https://graph.facebook.com/v2.9/oauth/access_token" + }, + "AttributeMapping": { + "username": "id" + }, + "IdpIdentifiers": [], + "LastModifiedDate": 1548105901.736, + "CreationDate": 1548105901.736 + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/describe-resource-server.rst b/bin/awscli/examples/cognito-idp/describe-resource-server.rst new file mode 100644 index 00000000..e9af34b6 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/describe-resource-server.rst @@ -0,0 +1,32 @@ +**To describe a resource server** + +This example describes the resource server weather.example.com. + +Command:: + + aws cognito-idp describe-resource-server --user-pool-id us-west-2_aaaaaaaaa --identifier weather.example.com + +Output:: + + { + "ResourceServer": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "Identifier": "weather.example.com", + "Name": "Weather", + "Scopes": [ + { + "ScopeName": "weather.update", + "ScopeDescription": "Update weather forecast" + }, + { + "ScopeName": "weather.read", + "ScopeDescription": "Read weather forecasts" + }, + { + "ScopeName": "weather.delete", + "ScopeDescription": "Delete a weather forecast" + } + ] + } + } + diff --git a/bin/awscli/examples/cognito-idp/describe-risk-configuration.rst b/bin/awscli/examples/cognito-idp/describe-risk-configuration.rst new file mode 100644 index 00000000..c1bb7d2c --- /dev/null +++ b/bin/awscli/examples/cognito-idp/describe-risk-configuration.rst @@ -0,0 +1,61 @@ +**To describe a risk configuration** + +This example describes the risk configuration associated with pool us-west-2_aaaaaaaaa. + +Command:: + + aws cognito-idp describe-risk-configuration --user-pool-id us-west-2_aaaaaaaaa + +Output:: + + { + "RiskConfiguration": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "CompromisedCredentialsRiskConfiguration": { + "EventFilter": [ + "SIGN_IN", + "SIGN_UP", + "PASSWORD_CHANGE" + ], + "Actions": { + "EventAction": "BLOCK" + } + }, + "AccountTakeoverRiskConfiguration": { + "NotifyConfiguration": { + "From": "diego@example.com", + "ReplyTo": "diego@example.com", + "SourceArn": "arn:aws:ses:us-east-1:111111111111:identity/diego@example.com", + "BlockEmail": { + "Subject": "Blocked sign-in attempt", + "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n

We blocked an unrecognized sign-in to your account with this information:\n\nTime: {login-time}
\nDevice: {device-name}
\nLocation: {city}, {country}
\n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know

\n\n", + "TextBody": "We blocked an unrecognized sign-in to your account with this information:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" + }, + "NoActionEmail": { + "Subject": "New sign-in attempt", + "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n

We observed an unrecognized sign-in to your account with this information:\n\nTime: {login-time}
\nDevice: {device-name}
\nLocation: {city}, {country}
\n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know

\n\n", + "TextBody": "We observed an unrecognized sign-in to your account with this information:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" + }, + "MfaEmail": { + "Subject": "New sign-in attempt", + "HtmlBody": "\n\n\n\tHTML email context\n\t\n\n\n

We required you to use multi-factor authentication for the following sign-in attempt:\n\nTime: {login-time}
\nDevice: {device-name}
\nLocation: {city}, {country}
\n
\nIf this sign-in was not by you, you should change your password and notify us by clicking on this link\nIf this sign-in was by you, you can follow this link to let us know

\n\n", + "TextBody": "We required you to use multi-factor authentication for the following sign-in attempt:\nTime: {login-time}\nDevice: {device-name}\nLocation: {city}, {country}\nIf this sign-in was not by you, you should change your password and notify us by clicking on {one-click-link-invalid}\nIf this sign-in was by you, you can follow {one-click-link-valid} to let us know" + } + }, + "Actions": { + "LowAction": { + "Notify": true, + "EventAction": "NO_ACTION" + }, + "MediumAction": { + "Notify": true, + "EventAction": "MFA_IF_CONFIGURED" + }, + "HighAction": { + "Notify": true, + "EventAction": "MFA_IF_CONFIGURED" + } + } + } + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/describe-user-import-job.rst b/bin/awscli/examples/cognito-idp/describe-user-import-job.rst new file mode 100644 index 00000000..2f791f78 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/describe-user-import-job.rst @@ -0,0 +1,28 @@ +**To describe a user import job** + +This example describes a user input job. + +For more information about importing users, see `Importing Users into User Pools From a CSV File`_. + +Command:: + + aws cognito-idp describe-user-import-job --user-pool-id us-west-2_aaaaaaaaa --job-id import-TZqNQvDRnW + +Output:: + + { + "UserImportJob": { + "JobName": "import-Test1", + "JobId": "import-TZqNQvDRnW", + "UserPoolId": "us-west-2_aaaaaaaaa", + "PreSignedUrl": "PRE_SIGNED URL", + "CreationDate": 1548271708.512, + "Status": "Created", + "CloudWatchLogsRoleArn": "arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole", + "ImportedUsers": 0, + "SkippedUsers": 0, + "FailedUsers": 0 + } + } + +.. _`Importing Users into User Pools From a CSV File`: https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-using-import-tool.html \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/describe-user-pool-client.rst b/bin/awscli/examples/cognito-idp/describe-user-pool-client.rst new file mode 100644 index 00000000..a8858bab --- /dev/null +++ b/bin/awscli/examples/cognito-idp/describe-user-pool-client.rst @@ -0,0 +1,70 @@ +**To describe a user pool client** + +This example describes a user pool client. + +Command:: + + aws cognito-idp describe-user-pool-client --user-pool-id us-west-2_aaaaaaaaa --client-id 38fjsnc484p94kpqsnet7mpld0 + +Output:: + + { + "UserPoolClient": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "ClientName": "MyApp", + "ClientId": "38fjsnc484p94kpqsnet7mpld0", + "ClientSecret": "CLIENT_SECRET", + "LastModifiedDate": 1548108676.163, + "CreationDate": 1548108676.163, + "RefreshTokenValidity": 30, + "ReadAttributes": [ + "address", + "birthdate", + "custom:CustomAttr1", + "custom:CustomAttr2", + "email", + "email_verified", + "family_name", + "gender", + "given_name", + "locale", + "middle_name", + "name", + "nickname", + "phone_number", + "phone_number_verified", + "picture", + "preferred_username", + "profile", + "updated_at", + "website", + "zoneinfo" + ], + "WriteAttributes": [ + "address", + "birthdate", + "custom:CustomAttr1", + "custom:CustomAttr2", + "email", + "family_name", + "gender", + "given_name", + "locale", + "middle_name", + "name", + "nickname", + "phone_number", + "picture", + "preferred_username", + "profile", + "updated_at", + "website", + "zoneinfo" + ], + "ExplicitAuthFlows": [ + "ADMIN_NO_SRP_AUTH", + "USER_PASSWORD_AUTH" + ], + "AllowedOAuthFlowsUserPoolClient": false + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/describe-user-pool-domain.rst b/bin/awscli/examples/cognito-idp/describe-user-pool-domain.rst new file mode 100644 index 00000000..8c64536f --- /dev/null +++ b/bin/awscli/examples/cognito-idp/describe-user-pool-domain.rst @@ -0,0 +1,22 @@ +**To describe a user pool client** + +This example describes a user pool domain named my-domain. + +Command:: + + aws cognito-idp describe-user-pool-domain --domain my-domain + +Output:: + + { + "DomainDescription": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "AWSAccountId": "111111111111", + "Domain": "my-domain", + "S3Bucket": "aws-cognito-prod-pdx-assets", + "CloudFrontDistribution": "aaaaaaaaaaaaa.cloudfront.net", + "Version": "20190128175402", + "Status": "ACTIVE", + "CustomDomainConfig": {} + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/describe-user-pool.rst b/bin/awscli/examples/cognito-idp/describe-user-pool.rst new file mode 100644 index 00000000..130a301f --- /dev/null +++ b/bin/awscli/examples/cognito-idp/describe-user-pool.rst @@ -0,0 +1,267 @@ +**To describe a user pool** + +This example describes a user pool with the user pool id us-west-2_aaaaaaaaa. + +Command:: + + aws cognito-idp describe-user-pool --user-pool-id us-west-2_aaaaaaaaa + +Output:: + + { + "UserPool": { + "SmsVerificationMessage": "Your verification code is {####}. ", + "SchemaAttributes": [ + { + "Name": "sub", + "StringAttributeConstraints": { + "MinLength": "1", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": true, + "AttributeDataType": "String", + "Mutable": false + }, + { + "Name": "name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "given_name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "family_name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "middle_name", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "nickname", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "preferred_username", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "profile", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "picture", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "website", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "email", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": true, + "AttributeDataType": "String", + "Mutable": true + }, + { + "AttributeDataType": "Boolean", + "DeveloperOnlyAttribute": false, + "Required": false, + "Name": "email_verified", + "Mutable": true + }, + { + "Name": "gender", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "birthdate", + "StringAttributeConstraints": { + "MinLength": "10", + "MaxLength": "10" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "zoneinfo", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "locale", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "phone_number", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "AttributeDataType": "Boolean", + "DeveloperOnlyAttribute": false, + "Required": false, + "Name": "phone_number_verified", + "Mutable": true + }, + { + "Name": "address", + "StringAttributeConstraints": { + "MinLength": "0", + "MaxLength": "2048" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "String", + "Mutable": true + }, + { + "Name": "updated_at", + "NumberAttributeConstraints": { + "MinValue": "0" + }, + "DeveloperOnlyAttribute": false, + "Required": false, + "AttributeDataType": "Number", + "Mutable": true + } + ], + "EmailVerificationSubject": "Your verification code", + "MfaConfiguration": "OFF", + "Name": "MyUserPool", + "EmailVerificationMessage": "Your verification code is {####}. ", + "SmsAuthenticationMessage": "Your authentication code is {####}. ", + "LastModifiedDate": 1547763720.822, + "AdminCreateUserConfig": { + "InviteMessageTemplate": { + "EmailMessage": "Your username is {username} and temporary password is {####}. ", + "EmailSubject": "Your temporary password", + "SMSMessage": "Your username is {username} and temporary password is {####}. " + }, + "UnusedAccountValidityDays": 7, + "AllowAdminCreateUserOnly": false + }, + "EmailConfiguration": { + "ReplyToEmailAddress": "myemail@mydomain.com" + "SourceArn": "arn:aws:ses:us-east-1:000000000000:identity/myemail@mydomain.com" + }, + "AutoVerifiedAttributes": [ + "email" + ], + "Policies": { + "PasswordPolicy": { + "RequireLowercase": true, + "RequireSymbols": true, + "RequireNumbers": true, + "MinimumLength": 8, + "RequireUppercase": true + } + }, + "UserPoolTags": {}, + "UsernameAttributes": [ + "email" + ], + "CreationDate": 1547763720.822, + "EstimatedNumberOfUsers": 1, + "Id": "us-west-2_aaaaaaaaa", + "LambdaConfig": {} + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/forget-device.rst b/bin/awscli/examples/cognito-idp/forget-device.rst new file mode 100644 index 00000000..5141fe69 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/forget-device.rst @@ -0,0 +1,8 @@ +**To forget a device** + +This example forgets device a device. + +Command:: + + aws cognito-idp forget-device --device-key us-west-2_abcd_1234-5678 + diff --git a/bin/awscli/examples/cognito-idp/forgot-password.rst b/bin/awscli/examples/cognito-idp/forgot-password.rst new file mode 100644 index 00000000..8ab382af --- /dev/null +++ b/bin/awscli/examples/cognito-idp/forgot-password.rst @@ -0,0 +1,15 @@ +**To force a password change** + +The following ``forgot-password`` example sends a message to jane@example.com to change their password. :: + + aws cognito-idp forgot-password --client-id 38fjsnc484p94kpqsnet7mpld0 --username jane@example.com + +Output:: + + { + "CodeDeliveryDetails": { + "Destination": "j***@e***.com", + "DeliveryMedium": "EMAIL", + "AttributeName": "email" + } + } diff --git a/bin/awscli/examples/cognito-idp/get-csv-header.rst b/bin/awscli/examples/cognito-idp/get-csv-header.rst new file mode 100644 index 00000000..6e6db1a8 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/get-csv-header.rst @@ -0,0 +1,40 @@ +**To create a csv header** + +This example creates a csv header. + +For more information about importing users, see `Importing Users into User Pools From a CSV File`_. + +Command:: + + aws cognito-idp get-csv-header --user-pool-id us-west-2_aaaaaaaaa + +Output:: + + { + "UserPoolId": "us-west-2_aaaaaaaaa", + "CSVHeader": [ + "name", + "given_name", + "family_name", + "middle_name", + "nickname", + "preferred_username", + "profile", + "picture", + "website", + "email", + "email_verified", + "gender", + "birthdate", + "zoneinfo", + "locale", + "phone_number", + "phone_number_verified", + "address", + "updated_at", + "cognito:mfa_enabled", + "cognito:username" + ] + } + +... _`Importing Users into User Pools From a CSV File`: https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-using-import-tool.html \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/get-group.rst b/bin/awscli/examples/cognito-idp/get-group.rst new file mode 100644 index 00000000..61a87756 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/get-group.rst @@ -0,0 +1,19 @@ +**To get information about a group** + +This example gets information about a group named MyGroup. + +Command:: + + aws cognito-idp get-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyGroup + +Output:: + + { + "Group": { + "GroupName": "MyGroup", + "UserPoolId": "us-west-2_aaaaaaaaa", + "Description": "A sample group.", + "LastModifiedDate": 1548270073.795, + "CreationDate": 1548270073.795 + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/get-signing-certificate.rst b/bin/awscli/examples/cognito-idp/get-signing-certificate.rst new file mode 100644 index 00000000..f7c26f1b --- /dev/null +++ b/bin/awscli/examples/cognito-idp/get-signing-certificate.rst @@ -0,0 +1,13 @@ +**To get a signing certificate** + +This example gets a signing certificate for a user pool. + +Command:: + + aws cognito-idp get-signing-certificate --user-pool-id us-west-2_aaaaaaaaa + +Output:: + + { + "Certificate": "CERTIFICATE_DATA" + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/get-ui-customization.rst b/bin/awscli/examples/cognito-idp/get-ui-customization.rst new file mode 100644 index 00000000..8943912c --- /dev/null +++ b/bin/awscli/examples/cognito-idp/get-ui-customization.rst @@ -0,0 +1,19 @@ +**To get UI customization information** + +This example gets UI customization information for a user pool. + +Command:: + + aws cognito-idp get-ui-customization --user-pool-id us-west-2_aaaaaaaaa + +Output:: + + { + "UICustomization": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "ClientId": "ALL", + "ImageUrl": "https://aaaaaaaaaaaaa.cloudfront.net/us-west-2_aaaaaaaaa/ALL/20190128231240/assets/images/image.jpg", + "CSS": ".logo-customizable {\n\tmax-width: 60%;\n\tmax-height: 30%;\n}\n.banner-customizable {\n\tpadding: 25px 0px 25px 10px;\n\tbackground-color: lightgray;\n}\n.label-customizable {\n\tfont-weight: 300;\n}\n.textDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.idpDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.legalText-customizable {\n\tcolor: #747474;\n\tfont-size: 11px;\n}\n.submitButton-customizable {\n\tfont-size: 14px;\n\tfont-weight: bold;\n\tmargin: 20px 0px 10px 0px;\n\theight: 40px;\n\twidth: 100%;\n\tcolor: #fff;\n\tbackground-color: #337ab7;\n}\n.submitButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #286090;\n}\n.errorMessage-customizable {\n\tpadding: 5px;\n\tfont-size: 14px;\n\twidth: 100%;\n\tbackground: #F5F5F5;\n\tborder: 2px solid #D64958;\n\tcolor: #D64958;\n}\n.inputField-customizable {\n\twidth: 100%;\n\theight: 34px;\n\tcolor: #555;\n\tbackground-color: #fff;\n\tborder: 1px solid #ccc;\n}\n.inputField-customizable:focus {\n\tborder-color: #66afe9;\n\toutline: 0;\n}\n.idpButton-customizable {\n\theight: 40px;\n\twidth: 100%;\n\ttext-align: center;\n\tmargin-bottom: 15px;\n\tcolor: #fff;\n\tbackground-color: #5bc0de;\n\tborder-color: #46b8da;\n}\n.idpButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #31b0d5;\n}\n.socialButton-customizable {\n\theight: 40px;\n\ttext-align: left;\n\twidth: 100%;\n\tmargin-bottom: 15px;\n}\n.redirect-customizable {\n\ttext-align: center;\n}\n.passwordCheck-notValid-customizable {\n\tcolor: #DF3312;\n}\n.passwordCheck-valid-customizable {\n\tcolor: #19BF00;\n}\n.background-customizable {\n\tbackground-color: #faf;\n}\n", + "CSSVersion": "20190128231240" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/list-user-import-jobs.rst b/bin/awscli/examples/cognito-idp/list-user-import-jobs.rst new file mode 100644 index 00000000..e279cd01 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/list-user-import-jobs.rst @@ -0,0 +1,57 @@ +**To list user import jobs** + +This example lists user import jobs. + +For more information about importing users, see `Importing Users into User Pools From a CSV File`_. + +Command:: + + aws cognito-idp list-user-import-jobs --user-pool-id us-west-2_aaaaaaaaa --max-results 20 + +Output:: + + { + "UserImportJobs": [ + { + "JobName": "Test2", + "JobId": "import-d0OnwGA3mV", + "UserPoolId": "us-west-2_aaaaaaaaa", + "PreSignedUrl": "PRE_SIGNED_URL", + "CreationDate": 1548272793.069, + "Status": "Created", + "CloudWatchLogsRoleArn": "arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole", + "ImportedUsers": 0, + "SkippedUsers": 0, + "FailedUsers": 0 + }, + { + "JobName": "Test1", + "JobId": "import-qQ0DCt2fRh", + "UserPoolId": "us-west-2_aaaaaaaaa", + "PreSignedUrl": "PRE_SIGNED_URL", + "CreationDate": 1548271795.471, + "Status": "Created", + "CloudWatchLogsRoleArn": "arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole", + "ImportedUsers": 0, + "SkippedUsers": 0, + "FailedUsers": 0 + }, + { + "JobName": "import-Test1", + "JobId": "import-TZqNQvDRnW", + "UserPoolId": "us-west-2_aaaaaaaaa", + "PreSignedUrl": "PRE_SIGNED_URL", + "CreationDate": 1548271708.512, + "StartDate": 1548277247.962, + "CompletionDate": 1548277248.912, + "Status": "Failed", + "CloudWatchLogsRoleArn": "arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole", + "ImportedUsers": 0, + "SkippedUsers": 0, + "FailedUsers": 1, + "CompletionMessage": "Too many users have failed or been skipped during the import." + } + ] + } + +.. _`Importing Users into User Pools From a CSV File`: https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-using-import-tool.html \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/list-user-pools.rst b/bin/awscli/examples/cognito-idp/list-user-pools.rst new file mode 100644 index 00000000..302487ef --- /dev/null +++ b/bin/awscli/examples/cognito-idp/list-user-pools.rst @@ -0,0 +1,22 @@ +**To list user pools** + +This example lists up to 20 user pools. + +Command:: + + aws cognito-idp list-user-pools --max-results 20 + +Output:: + + { + "UserPools": [ + { + "CreationDate": 1547763720.822, + "LastModifiedDate": 1547763720.822, + "LambdaConfig": {}, + "Id": "us-west-2_aaaaaaaaa", + "Name": "MyUserPool" + } + ] + } + diff --git a/bin/awscli/examples/cognito-idp/list-users-in-group.rst b/bin/awscli/examples/cognito-idp/list-users-in-group.rst new file mode 100644 index 00000000..25c54c8b --- /dev/null +++ b/bin/awscli/examples/cognito-idp/list-users-in-group.rst @@ -0,0 +1,56 @@ +**To list users in a group** + +This example lists users in group MyGroup. + +Command:: + + aws cognito-idp list-users-in-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyGroup + +Output:: + + { + "Users": [ + { + "Username": "acf10624-80bb-401a-ac61-607bee2110ec", + "Attributes": [ + { + "Name": "sub", + "Value": "acf10624-80bb-401a-ac61-607bee2110ec" + }, + { + "Name": "custom:CustomAttr1", + "Value": "New Value!" + }, + { + "Name": "email", + "Value": "jane@example.com" + } + ], + "UserCreateDate": 1548102770.284, + "UserLastModifiedDate": 1548103204.893, + "Enabled": true, + "UserStatus": "CONFIRMED" + }, + { + "Username": "22704aa3-fc10-479a-97eb-2af5806bd327", + "Attributes": [ + { + "Name": "sub", + "Value": "22704aa3-fc10-479a-97eb-2af5806bd327" + }, + { + "Name": "email_verified", + "Value": "true" + }, + { + "Name": "email", + "Value": "diego@example.com" + } + ], + "UserCreateDate": 1548089817.683, + "UserLastModifiedDate": 1548089817.683, + "Enabled": true, + "UserStatus": "FORCE_CHANGE_PASSWORD" + } + ] + } diff --git a/bin/awscli/examples/cognito-idp/list-users.rst b/bin/awscli/examples/cognito-idp/list-users.rst new file mode 100644 index 00000000..6245e17c --- /dev/null +++ b/bin/awscli/examples/cognito-idp/list-users.rst @@ -0,0 +1,35 @@ +**To list users** + +This example lists up to 20 users. + +Command:: + + aws cognito-idp list-users --user-pool-id us-west-2_aaaaaaaaa --limit 20 + +Output:: + + { + "Users": [ + { + "Username": "22704aa3-fc10-479a-97eb-2af5806bd327", + "Enabled": true, + "UserStatus": "FORCE_CHANGE_PASSWORD", + "UserCreateDate": 1548089817.683, + "UserLastModifiedDate": 1548089817.683, + "Attributes": [ + { + "Name": "sub", + "Value": "22704aa3-fc10-479a-97eb-2af5806bd327" + }, + { + "Name": "email_verified", + "Value": "true" + }, + { + "Name": "email", + "Value": "mary@example.com" + } + ] + } + ] + } diff --git a/bin/awscli/examples/cognito-idp/resend-confirmation-code.rst b/bin/awscli/examples/cognito-idp/resend-confirmation-code.rst new file mode 100644 index 00000000..7bf38c6d --- /dev/null +++ b/bin/awscli/examples/cognito-idp/resend-confirmation-code.rst @@ -0,0 +1,17 @@ +**To force a password change** + +This example sends a message to jane@example.com to change their password. + +Command:: + + aws cognito-idp forget-device --client-id 38fjsnc484p94kpqsnet7mpld0 --username jane@example.com + +Output:: + + { + "CodeDeliveryDetails": { + "Destination": "j***@e***.com", + "DeliveryMedium": "EMAIL", + "AttributeName": "email" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/respond-to-auth-challenge.rst b/bin/awscli/examples/cognito-idp/respond-to-auth-challenge.rst new file mode 100644 index 00000000..282d97eb --- /dev/null +++ b/bin/awscli/examples/cognito-idp/respond-to-auth-challenge.rst @@ -0,0 +1,27 @@ +**To respond to an authorization challenge** + +This example responds to an authorization challenge initiated with `initiate-auth`_. It is a response to the NEW_PASSWORD_REQUIRED challenge. +It sets a password for user jane@example.com. + +Command:: + + aws cognito-idp respond-to-auth-challenge --client-id 3n4b5urk1ft4fl3mg5e62d9ado --challenge-name NEW_PASSWORD_REQUIRED --challenge-responses USERNAME=jane@example.com,NEW_PASSWORD="password" --session "SESSION_TOKEN" + +Output:: + + { + "ChallengeParameters": {}, + "AuthenticationResult": { + "AccessToken": "ACCESS_TOKEN", + "ExpiresIn": 3600, + "TokenType": "Bearer", + "RefreshToken": "REFRESH_TOKEN", + "IdToken": "ID_TOKEN", + "NewDeviceMetadata": { + "DeviceKey": "us-west-2_fec070d2-fa88-424a-8ec8-b26d7198eb23", + "DeviceGroupKey": "-wt2ha1Zd" + } + } + } + +.. _`initiate-auth`: https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/initiate-auth.html \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/set-risk-configuration.rst b/bin/awscli/examples/cognito-idp/set-risk-configuration.rst new file mode 100644 index 00000000..5c78c0a9 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/set-risk-configuration.rst @@ -0,0 +1,23 @@ +**To set risk configuration** + +This example sets the risk configuration for a user pool. It sets the sign-up event action to NO_ACTION. + +Command:: + + aws cognito-idp set-risk-configuration --user-pool-id us-west-2_aaaaaaaaa --compromised-credentials-risk-configuration EventFilter=SIGN_UP,Actions={EventAction=NO_ACTION} + +Output:: + + { + "RiskConfiguration": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "CompromisedCredentialsRiskConfiguration": { + "EventFilter": [ + "SIGN_UP" + ], + "Actions": { + "EventAction": "NO_ACTION" + } + } + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/set-ui-customization.rst b/bin/awscli/examples/cognito-idp/set-ui-customization.rst new file mode 100644 index 00000000..7864e3a7 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/set-ui-customization.rst @@ -0,0 +1,18 @@ +**To set UI customization** + +This example customizes the CSS setting for a user pool. + +Command:: + + aws cognito-idp set-ui-customization --user-pool-id us-west-2_aaaaaaaaa --css ".logo-customizable {\n\tmax-width: 60%;\n\tmax-height: 30%;\n}\n.banner-customizable {\n\tpadding: 25px 0px 25px 10px;\n\tbackground-color: lightgray;\n}\n.label-customizable {\n\tfont-weight: 300;\n}\n.textDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.idpDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.legalText-customizable {\n\tcolor: #747474;\n\tfont-size: 11px;\n}\n.submitButton-customizable {\n\tfont-size: 14px;\n\tfont-weight: bold;\n\tmargin: 20px 0px 10px 0px;\n\theight: 40px;\n\twidth: 100%;\n\tcolor: #fff;\n\tbackground-color: #337ab7;\n}\n.submitButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #286090;\n}\n.errorMessage-customizable {\n\tpadding: 5px;\n\tfont-size: 14px;\n\twidth: 100%;\n\tbackground: #F5F5F5;\n\tborder: 2px solid #D64958;\n\tcolor: #D64958;\n}\n.inputField-customizable {\n\twidth: 100%;\n\theight: 34px;\n\tcolor: #555;\n\tbackground-color: #fff;\n\tborder: 1px solid #ccc;\n}\n.inputField-customizable:focus {\n\tborder-color: #66afe9;\n\toutline: 0;\n}\n.idpButton-customizable {\n\theight: 40px;\n\twidth: 100%;\n\ttext-align: center;\n\tmargin-bottom: 15px;\n\tcolor: #fff;\n\tbackground-color: #5bc0de;\n\tborder-color: #46b8da;\n}\n.idpButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #31b0d5;\n}\n.socialButton-customizable {\n\theight: 40px;\n\ttext-align: left;\n\twidth: 100%;\n\tmargin-bottom: 15px;\n}\n.redirect-customizable {\n\ttext-align: center;\n}\n.passwordCheck-notValid-customizable {\n\tcolor: #DF3312;\n}\n.passwordCheck-valid-customizable {\n\tcolor: #19BF00;\n}\n.background-customizable {\n\tbackground-color: #faf;\n}\n" + +Output:: + + { + "UICustomization": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "ClientId": "ALL", + "CSS": ".logo-customizable {\n\tmax-width: 60%;\n\tmax-height: 30%;\n}\n.banner-customizable {\n\tpadding: 25px 0px 25px 10px;\n\tbackground-color: lightgray;\n}\n.label-customizable {\n\tfont-weight: 300;\n}\n.textDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.idpDescription-customizable {\n\tpadding-top: 10px;\n\tpadding-bottom: 10px;\n\tdisplay: block;\n\tfont-size: 16px;\n}\n.legalText-customizable {\n\tcolor: #747474;\n\tfont-size: 11px;\n}\n.submitButton-customizable {\n\tfont-size: 14px;\n\tfont-weight: bold;\n\tmargin: 20px 0px 10px 0px;\n\theight: 40px;\n\twidth: 100%;\n\tcolor: #fff;\n\tbackground-color: #337ab7;\n}\n.submitButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #286090;\n}\n.errorMessage-customizable {\n\tpadding: 5px;\n\tfont-size: 14px;\n\twidth: 100%;\n\tbackground: #F5F5F5;\n\tborder: 2px solid #D64958;\n\tcolor: #D64958;\n}\n.inputField-customizable {\n\twidth: 100%;\n\theight: 34px;\n\tcolor: #555;\n\tbackground-color: #fff;\n\tborder: 1px solid #ccc;\n}\n.inputField-customizable:focus {\n\tborder-color: #66afe9;\n\toutline: 0;\n}\n.idpButton-customizable {\n\theight: 40px;\n\twidth: 100%;\n\ttext-align: center;\n\tmargin-bottom: 15px;\n\tcolor: #fff;\n\tbackground-color: #5bc0de;\n\tborder-color: #46b8da;\n}\n.idpButton-customizable:hover {\n\tcolor: #fff;\n\tbackground-color: #31b0d5;\n}\n.socialButton-customizable {\n\theight: 40px;\n\ttext-align: left;\n\twidth: 100%;\n\tmargin-bottom: 15px;\n}\n.redirect-customizable {\n\ttext-align: center;\n}\n.passwordCheck-notValid-customizable {\n\tcolor: #DF3312;\n}\n.passwordCheck-valid-customizable {\n\tcolor: #19BF00;\n}\n.background-customizable {\n\tbackground-color: #faf;\n}\n", + "CSSVersion": "20190129172214" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/set-user-mfa-preference.rst b/bin/awscli/examples/cognito-idp/set-user-mfa-preference.rst new file mode 100644 index 00000000..95f49bf1 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/set-user-mfa-preference.rst @@ -0,0 +1,8 @@ +**To set user MFA settings** + +This example modifies the MFA delivery options. It changes the MFA delivery medium to SMS. + +Command:: + + aws cognito-idp set-user-mfa-preference --access-token ACCESS_TOKEN --mfa-options DeliveryMedium="SMS",AttributeName="phone_number" + diff --git a/bin/awscli/examples/cognito-idp/set-user-settings.rst b/bin/awscli/examples/cognito-idp/set-user-settings.rst new file mode 100644 index 00000000..0a5973f8 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/set-user-settings.rst @@ -0,0 +1,8 @@ +**To set user settings** + +This example sets the MFA delivery preference to EMAIL. + +Command:: + + aws cognito-idp set-user-settings --access-token ACCESS_TOKEN --mfa-options DeliveryMedium=EMAIL + diff --git a/bin/awscli/examples/cognito-idp/sign-up.rst b/bin/awscli/examples/cognito-idp/sign-up.rst new file mode 100644 index 00000000..7ab74233 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/sign-up.rst @@ -0,0 +1,14 @@ +**To sign up a user** + +This example signs up jane@example.com. + +Command:: + + aws cognito-idp sign-up --client-id 3n4b5urk1ft4fl3mg5e62d9ado --username jane@example.com --password PASSWORD --user-attributes Name="email",Value="jane@example.com" Name="name",Value="Jane" + +Output:: + + { + "UserConfirmed": false, + "UserSub": "e04d60a6-45dc-441c-a40b-e25a787d4862" + } diff --git a/bin/awscli/examples/cognito-idp/start-user-import-job.rst b/bin/awscli/examples/cognito-idp/start-user-import-job.rst new file mode 100644 index 00000000..e33be386 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/start-user-import-job.rst @@ -0,0 +1,29 @@ +**To start a user import job** + +This example starts a user input job. + +For more information about importing users, see `Importing Users into User Pools From a CSV File`_. + +Command:: + + aws cognito-idp start-user-import-job --user-pool-id us-west-2_aaaaaaaaa --job-id import-TZqNQvDRnW + +Output:: + + { + "UserImportJob": { + "JobName": "import-Test10", + "JobId": "import-lmpxSOuIzH", + "UserPoolId": "us-west-2_aaaaaaaaa", + "PreSignedUrl": "PRE_SIGNED_URL", + "CreationDate": 1548278378.928, + "StartDate": 1548278397.334, + "Status": "Pending", + "CloudWatchLogsRoleArn": "arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole", + "ImportedUsers": 0, + "SkippedUsers": 0, + "FailedUsers": 0 + } + } + +.. _`Importing Users into User Pools From a CSV File`: https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-using-import-tool.html \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/stop-user-import-job.rst b/bin/awscli/examples/cognito-idp/stop-user-import-job.rst new file mode 100644 index 00000000..4d62b7f1 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/stop-user-import-job.rst @@ -0,0 +1,31 @@ +**To stop a user import job** + +This example stops a user input job. + +For more information about importing users, see `Importing Users into User Pools From a CSV File`_. + +Command:: + + aws cognito-idp stop-user-import-job --user-pool-id us-west-2_aaaaaaaaa --job-id import-TZqNQvDRnW + +Output:: + + { + "UserImportJob": { + "JobName": "import-Test5", + "JobId": "import-Fx0kARISFL", + "UserPoolId": "us-west-2_aaaaaaaaa", + "PreSignedUrl": "PRE_SIGNED_URL", + "CreationDate": 1548278576.259, + "StartDate": 1548278623.366, + "CompletionDate": 1548278626.741, + "Status": "Stopped", + "CloudWatchLogsRoleArn": "arn:aws:iam::111111111111:role/CognitoCloudWatchLogsRole", + "ImportedUsers": 0, + "SkippedUsers": 0, + "FailedUsers": 0, + "CompletionMessage": "The Import Job was stopped by the developer." + } + } + +.. _`Importing Users into User Pools From a CSV File`: https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-using-import-tool.html \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/update-auth-event-feedback.rst b/bin/awscli/examples/cognito-idp/update-auth-event-feedback.rst new file mode 100644 index 00000000..b84b711c --- /dev/null +++ b/bin/awscli/examples/cognito-idp/update-auth-event-feedback.rst @@ -0,0 +1,7 @@ +**To update auth event feedback** + +This example updates authorization event feedback. It marks the event "Valid". + +Command:: + + aws cognito-idp update-auth-event-feedback --user-pool-id us-west-2_aaaaaaaaa --username diego@example.com --event-id EVENT_ID --feedback-token FEEDBACK_TOKEN --feedback-value "Valid" diff --git a/bin/awscli/examples/cognito-idp/update-device-status.rst b/bin/awscli/examples/cognito-idp/update-device-status.rst new file mode 100644 index 00000000..cabe6bff --- /dev/null +++ b/bin/awscli/examples/cognito-idp/update-device-status.rst @@ -0,0 +1,7 @@ +**To update device status** + +This example updates the status for a device to "not_remembered". + +Command:: + + aws cognito-idp update-device-status --access-token ACCESS_TOKEN --device-key DEVICE_KEY --device-remembered-status "not_remembered" diff --git a/bin/awscli/examples/cognito-idp/update-group.rst b/bin/awscli/examples/cognito-idp/update-group.rst new file mode 100644 index 00000000..88d60ba0 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/update-group.rst @@ -0,0 +1,21 @@ +**To update a group** + +This example updates the description and precedence for MyGroup. + +Command:: + + aws cognito-idp update-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyGroup --description "New description" --precedence 2 + +Output:: + + { + "Group": { + "GroupName": "MyGroup", + "UserPoolId": "us-west-2_aaaaaaaaa", + "Description": "New description", + "RoleArn": "arn:aws:iam::111111111111:role/MyRole", + "Precedence": 2, + "LastModifiedDate": 1548800862.812, + "CreationDate": 1548097827.125 + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/update-resource-server.rst b/bin/awscli/examples/cognito-idp/update-resource-server.rst new file mode 100644 index 00000000..4b06e89e --- /dev/null +++ b/bin/awscli/examples/cognito-idp/update-resource-server.rst @@ -0,0 +1,23 @@ +**To update a resource server** + +This example updates the the resource server Weather. It adds a new scope. + +Command:: + + aws cognito-idp update-resource-server --user-pool-id us-west-2_aaaaaaaaa --identifier weather.example.com --name Weather --scopes ScopeName=NewScope,ScopeDescription="New scope description" + +Output:: + + { + "ResourceServer": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "Identifier": "weather.example.com", + "Name": "Happy", + "Scopes": [ + { + "ScopeName": "NewScope", + "ScopeDescription": "New scope description" + } + ] + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/update-user-attributes.rst b/bin/awscli/examples/cognito-idp/update-user-attributes.rst new file mode 100644 index 00000000..3f723772 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/update-user-attributes.rst @@ -0,0 +1,7 @@ +**To update user attributes** + +This example updates the user attribute "nickname". + +Command:: + + aws cognito-idp update-user-attributes --access-token ACCESS_TOKEN --user-attributes Name="nickname",Value="Dan" diff --git a/bin/awscli/examples/cognito-idp/update-user-pool-client.rst b/bin/awscli/examples/cognito-idp/update-user-pool-client.rst new file mode 100644 index 00000000..b2f922eb --- /dev/null +++ b/bin/awscli/examples/cognito-idp/update-user-pool-client.rst @@ -0,0 +1,24 @@ +**To update a user pool client** + +This example updates the name of a user pool client. It also adds a writeable attribute "nickname". + +Command:: + + aws cognito-idp update-user-pool-client --user-pool-id us-west-2_aaaaaaaaa --client-id 3n4b5urk1ft4fl3mg5e62d9ado --client-name "NewClientName" --write-attributes "nickname" + +Output:: + + { + "UserPoolClient": { + "UserPoolId": "us-west-2_aaaaaaaaa", + "ClientName": "NewClientName", + "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado", + "LastModifiedDate": 1548802761.334, + "CreationDate": 1548178931.258, + "RefreshTokenValidity": 30, + "WriteAttributes": [ + "nickname" + ], + "AllowedOAuthFlowsUserPoolClient": false + } + } \ No newline at end of file diff --git a/bin/awscli/examples/cognito-idp/update-user-pool.rst b/bin/awscli/examples/cognito-idp/update-user-pool.rst new file mode 100644 index 00000000..a3948e59 --- /dev/null +++ b/bin/awscli/examples/cognito-idp/update-user-pool.rst @@ -0,0 +1,7 @@ +**To update a user pool** + +This example adds tags to a user pool. + +Command:: + + aws cognito-idp update-user-pool --user-pool-id us-west-2_aaaaaaaaa --user-pool-tags Team=Blue,Area=West diff --git a/bin/awscli/examples/cur/delete-report-definition.rst b/bin/awscli/examples/cur/delete-report-definition.rst new file mode 100644 index 00000000..bf80fd06 --- /dev/null +++ b/bin/awscli/examples/cur/delete-report-definition.rst @@ -0,0 +1,7 @@ +**To delete an AWS Cost and Usage Report** + +This example deletes an AWS Cost and Usage Report. + +Command:: + + aws cur --region us-east-1 delete-report-definition --report-name "ExampleReport" diff --git a/bin/awscli/examples/cur/describe-report-definitions.rst b/bin/awscli/examples/cur/describe-report-definitions.rst new file mode 100644 index 00000000..039d5e0c --- /dev/null +++ b/bin/awscli/examples/cur/describe-report-definitions.rst @@ -0,0 +1,31 @@ + +**To retrieve a list of AWS Cost and Usage Reports** + +This example describes a list of AWS Cost and Usage Reports owned by an account. + +Command:: + + aws cur --region us-east-1 describe-report-definitions --max-items 5 + +Output:: + + { + "ReportDefinitions": [ + { + "ReportName": "ExampleReport", + "Compression": "ZIP", + "S3Region": "us-east-1", + "Format": "textORcsv", + "S3Prefix": "exampleprefix", + "S3Bucket": "example-s3-bucket", + "TimeUnit": "DAILY", + "AdditionalArtifacts": [ + "REDSHIFT", + "QUICKSIGHT" + ], + "AdditionalSchemaElements": [ + "RESOURCES" + ] + } + ] + } diff --git a/bin/awscli/examples/cur/put-report-definition.rst b/bin/awscli/examples/cur/put-report-definition.rst new file mode 100644 index 00000000..be97908e --- /dev/null +++ b/bin/awscli/examples/cur/put-report-definition.rst @@ -0,0 +1,26 @@ + +**To create an AWS Cost and Usage Reports** + +The following ``put-report-definition`` example creates a daily AWS Cost and Usage Report that you can upload into Amazon Redshift or Amazon QuickSight. :: + + aws cur put-report-definition --report-definition file://report-definition.json + +Contents of ``report-definition.json``:: + + { + "ReportName": "ExampleReport", + "TimeUnit": "DAILY", + "Format": "textORcsv", + "Compression": "ZIP", + "AdditionalSchemaElements": [ + "RESOURCES" + ], + "S3Bucket": "example-s3-bucket", + "S3Prefix": "exampleprefix", + "S3Region": "us-east-1", + "AdditionalArtifacts": [ + "REDSHIFT", + "QUICKSIGHT" + ] + } + diff --git a/bin/awscli/examples/datapipeline/list-runs.rst b/bin/awscli/examples/datapipeline/list-runs.rst index 99a1edf0..841b4686 100644 --- a/bin/awscli/examples/datapipeline/list-runs.rst +++ b/bin/awscli/examples/datapipeline/list-runs.rst @@ -1,29 +1,20 @@ -**To list your pipeline runs** +**Example 1: To list your pipeline runs** -This example lists the runs for the specified pipeline:: +The following ``list-runs`` example lists the runs for the specified pipeline. :: - aws datapipeline list-runs --pipeline-id df-00627471SOVYZEXAMPLE - -The following is example output:: + aws datapipeline list-runs --pipeline-id df-00627471SOVYZEXAMPLE - Name Scheduled Start Status ID Started Ended - ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - 1. EC2ResourceObj 2015-04-12T17:33:02 CREATING @EC2ResourceObj_2015-04-12T17:33:02 2015-04-12T17:33:10 +Output:: - 2. S3InputLocation 2015-04-12T17:33:02 FINISHED @S3InputLocation_2015-04-12T17:33:02 2015-04-12T17:33:09 2015-04-12T17:33:09 + Name Scheduled Start Status ID Started Ended + ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- + 1. EC2ResourceObj 2015-04-12T17:33:02 CREATING @EC2ResourceObj_2015-04-12T17:33:02 2015-04-12T17:33:10 + 2. S3InputLocation 2015-04-12T17:33:02 FINISHED @S3InputLocation_2015-04-12T17:33:02 2015-04-12T17:33:09 2015-04-12T17:33:09 + 3. S3OutputLocation 2015-04-12T17:33:02 WAITING_ON_DEPENDENCIES @S3OutputLocation_2015-04-12T17:33:02 2015-04-12T17:33:09 + 4. ShellCommandActivityObj 2015-04-12T17:33:02 WAITING_FOR_RUNNER @ShellCommandActivityObj_2015-04-12T17:33:02 2015-04-12T17:33:09 - 3. S3OutputLocation 2015-04-12T17:33:02 WAITING_ON_DEPENDENCIES @S3OutputLocation_2015-04-12T17:33:02 2015-04-12T17:33:09 +**Example 2: To list the pipeline runs between the specified dates** - 4. ShellCommandActivityObj 2015-04-12T17:33:02 WAITING_FOR_RUNNER @ShellCommandActivityObj_2015-04-12T17:33:02 2015-04-12T17:33:09 +The following ``list-runs`` example uses the ``--start-interval`` to specify the dates to include in the output. :: -**To list the pipeline runs between the specified dates** - -Use the ``list-runs`` command with the ``--start-interval`` parameter:: - - aws datapipeline list-runs`` --pipeline-id {#PIPELINE_ID} --start-interval {#TIME},{#TIME} - -For example, to list the pipeline runs between 2017-10-07T00:00:00 and 2017-10-08T00:00:00, run:: - - aws datapipeline list-runs --pipeline-id df-01434553B58A2SHZUKO5 --start-interval 2017-10-07T00:00:00,2017-10-08T00:00:00 - - + aws datapipeline list-runs --pipeline-id df-01434553B58A2SHZUKO5 --start-interval 2017-10-07T00:00:00,2017-10-08T00:00:00 diff --git a/bin/awscli/examples/deploy/add-tags-to-on-premises-instances.rst b/bin/awscli/examples/deploy/add-tags-to-on-premises-instances.rst old mode 100644 new mode 100755 index 060b735c..747c79d8 --- a/bin/awscli/examples/deploy/add-tags-to-on-premises-instances.rst +++ b/bin/awscli/examples/deploy/add-tags-to-on-premises-instances.rst @@ -1,11 +1,9 @@ **To add tags to on-premises instances** -This example associates in AWS CodeDeploy the same on-premises instance tag to two on-premises instances. It does not register the on-premises instances with AWS CodeDeploy. +The follwoing ``add-tags-to-on-premises-instances`` example associates in AWS CodeDeploy the same on-premises instance tag to two on-premises instances. It does not register the on-premises instances with AWS CodeDeploy. :: -Command:: + aws deploy add-tags-to-on-premises-instances \ + --instance-names AssetTag12010298EX AssetTag23121309EX \ + --tags Key=Name,Value=CodeDeployDemo-OnPrem - aws deploy add-tags-to-on-premises-instances --instance-names AssetTag12010298EX AssetTag23121309EX --tags Key=Name,Value=CodeDeployDemo-OnPrem - -Output:: - - This command produces no output. \ No newline at end of file +This command produces no output. diff --git a/bin/awscli/examples/deploy/batch-get-application-revisions.rst b/bin/awscli/examples/deploy/batch-get-application-revisions.rst new file mode 100755 index 00000000..5e0fdbdf --- /dev/null +++ b/bin/awscli/examples/deploy/batch-get-application-revisions.rst @@ -0,0 +1,34 @@ +**To retrieve information about application revisions** + +The following ``batch-get-application-revisions`` example retrieves information about the specified revision stored in a GitHub repository. :: + + aws deploy batch-get-application-revisions \ + --application-name my-codedeploy-application \ + --revisions "[{\"gitHubLocation\": {\"commitId\": \"fa85936EXAMPLEa31736c051f10d77297EXAMPLE\",\"repository\": \"my-github-token/my-repository\"},\"revisionType\": \"GitHub\"}]" + +Output:: + + { + "revisions": [ + { + "genericRevisionInfo": { + "description": "Application revision registered by Deployment ID: d-A1B2C3111", + "lastUsedTime": 1556912355.884, + "registerTime": 1556912355.884, + "firstUsedTime": 1556912355.884, + "deploymentGroups": [] + }, + "revisionLocation": { + "revisionType": "GitHub", + "gitHubLocation": { + "commitId": "fa85936EXAMPLEa31736c051f10d77297EXAMPLE", + "repository": "my-github-token/my-repository" + } + } + } + ], + "applicationName": "my-codedeploy-application", + "errorMessage": "" + } + +For more information, see `BatchGetApplicationRevisions `_ in the *AWS CodeDeploy API Reference*. diff --git a/bin/awscli/examples/deploy/batch-get-applications.rst b/bin/awscli/examples/deploy/batch-get-applications.rst old mode 100644 new mode 100755 index 4076f60d..5dc5b163 --- a/bin/awscli/examples/deploy/batch-get-applications.rst +++ b/bin/awscli/examples/deploy/batch-get-applications.rst @@ -1,26 +1,24 @@ **To get information about multiple applications** -This example displays information about multiple applications that are associated with the user's AWS account. +The following ``batch-get-applications`` example displays information about multiple applications that are associated with the user's AWS account. :: -Command:: - - aws deploy batch-get-applications --application-names WordPress_App MyOther_App + aws deploy batch-get-applications --application-names WordPress_App MyOther_App Output:: - { - "applicationsInfo": [ - { - "applicationName": "WordPress_App", - "applicationId": "d9dd6993-f171-44fa-a811-211e4EXAMPLE", - "createTime": 1407878168.078, - "linkedToGitHub": false - }, - { - "applicationName": "MyOther_App", - "applicationId": "8ca57519-31da-42b2-9194-8bb16EXAMPLE", - "createTime": 1407453571.63, - "linkedToGitHub": false - } - ] - } \ No newline at end of file + { + "applicationsInfo": [ + { + "applicationName": "WordPress_App", + "applicationId": "d9dd6993-f171-44fa-a811-211e4EXAMPLE", + "createTime": 1407878168.078, + "linkedToGitHub": false + }, + { + "applicationName": "MyOther_App", + "applicationId": "8ca57519-31da-42b2-9194-8bb16EXAMPLE", + "createTime": 1407453571.63, + "linkedToGitHub": false + } + ] + } diff --git a/bin/awscli/examples/deploy/batch-get-deployment-groups.rst b/bin/awscli/examples/deploy/batch-get-deployment-groups.rst new file mode 100755 index 00000000..6b9d1581 --- /dev/null +++ b/bin/awscli/examples/deploy/batch-get-deployment-groups.rst @@ -0,0 +1,86 @@ +**To retrieve information about one or more deployment groups** + +The following ``batch-get-deployment-groups`` example retrieves information about two of the deployment groups that are associated with the specified CodeDeploy application. :: + + aws deploy batch-get-deployment-groups \ + --application-name my-codedeploy-application \ + --deployment-group-names "[\"my-deployment-group-1\",\"my-deployment-group-2\"]" + +Output:: + + { + "deploymentGroupsInfo": [ + { + "deploymentStyle": { + "deploymentOption": "WITHOUT_TRAFFIC_CONTROL", + "deploymentType": "IN_PLACE" + }, + "autoRollbackConfiguration": { + "enabled": false + }, + "onPremisesTagSet": { + "onPremisesTagSetList": [] + }, + "serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeloyServiceRole", + "lastAttemptedDeployment": { + "endTime": 1556912366.415, + "status": "Failed", + "createTime": 1556912355.884, + "deploymentId": "d-A1B2C3111" + }, + "autoScalingGroups": [], + "deploymentGroupName": "my-deployment-group-1", + "ec2TagSet": { + "ec2TagSetList": [ + [ + { + "Type": "KEY_AND_VALUE", + "Value": "my-EC2-instance", + "Key": "Name" + } + ] + ] + }, + "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111example", + "triggerConfigurations": [], + "applicationName": "my-codedeploy-application", + "computePlatform": "Server", + "deploymentConfigName": "CodeDeployDefault.AllAtOnce" + }, + { + "deploymentStyle": { + "deploymentOption": "WITHOUT_TRAFFIC_CONTROL", + "deploymentType": "IN_PLACE" + }, + "autoRollbackConfiguration": { + "enabled": false + }, + "onPremisesTagSet": { + "onPremisesTagSetList": [] + }, + "serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeloyServiceRole", + "autoScalingGroups": [], + "deploymentGroupName": "my-deployment-group-2", + "ec2TagSet": { + "ec2TagSetList": [ + [ + { + "Type": "KEY_AND_VALUE", + "Value": "my-EC2-instance", + "Key": "Name" + } + ] + ] + }, + "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-22222example", + "triggerConfigurations": [], + "applicationName": "my-codedeploy-application", + "computePlatform": "Server", + "deploymentConfigName": "CodeDeployDefault.AllAtOnce" + } + ], + "errorMessage": "" + } + +For more information, see `BatchGetDeploymentGroups `_ in the *AWS CodeDeploy API Reference*. + \ No newline at end of file diff --git a/bin/awscli/examples/deploy/batch-get-deployment-targets.rst b/bin/awscli/examples/deploy/batch-get-deployment-targets.rst new file mode 100755 index 00000000..c245e5c0 --- /dev/null +++ b/bin/awscli/examples/deploy/batch-get-deployment-targets.rst @@ -0,0 +1,64 @@ +**To retrieve the targets associated with a deployment** + +The following ``batch-get-deployment-targets`` example returns information about one of the targets associated with the specified deployment. :: + + aws deploy batch-get-deployment-targets \ + --deployment-id "d-1A2B3C4D5" \ + --target-ids "i-01a2b3c4d5e6f1111" + +Output:: + + { + "deploymentTargets": [ + { + "deploymentTargetType": "InstanceTarget", + "instanceTarget": { + "lifecycleEvents": [ + { + "startTime": 1556918592.162, + "lifecycleEventName": "ApplicationStop", + "status": "Succeeded", + "endTime": 1556918592.247, + "diagnostics": { + "scriptName": "", + "errorCode": "Success", + "logTail": "", + "message": "Succeeded" + } + }, + { + "startTime": 1556918593.193, + "lifecycleEventName": "DownloadBundle", + "status": "Succeeded", + "endTime": 1556918593.981, + "diagnostics": { + "scriptName": "", + "errorCode": "Success", + "logTail": "", + "message": "Succeeded" + } + }, + { + "startTime": 1556918594.805, + "lifecycleEventName": "BeforeInstall", + "status": "Succeeded", + "endTime": 1556918681.807, + "diagnostics": { + "scriptName": "", + "errorCode": "Success", + "logTail": "", + "message": "Succeeded" + } + } + ], + "targetArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-01a2b3c4d5e6f1111", + "deploymentId": "d-1A2B3C4D5", + "lastUpdatedAt": 1556918687.504, + "targetId": "i-01a2b3c4d5e6f1111", + "status": "Succeeded" + } + } + ] + } + +For more information, see `BatchGetDeploymentTargets `_ in the *AWS CodeDeploy API Reference*. diff --git a/bin/awscli/examples/deploy/batch-get-deployments.rst b/bin/awscli/examples/deploy/batch-get-deployments.rst old mode 100644 new mode 100755 index 488faa4d..0e2d8fb8 --- a/bin/awscli/examples/deploy/batch-get-deployments.rst +++ b/bin/awscli/examples/deploy/batch-get-deployments.rst @@ -1,70 +1,68 @@ **To get information about multiple deployments** -This example displays information about multiple deployments that are associated with the user's AWS account. +The following ``batch-get-deployments`` example displays information about multiple deployments that are associated with the user's AWS account. :: -Command:: - - aws deploy batch-get-deployments --deployment-ids d-USUAELQEX d-QA4G4F9EX + aws deploy batch-get-deployments --deployment-ids d-A1B2C3111 d-A1B2C3222 Output:: - { - "deploymentsInfo": [ - { - "applicationName": "WordPress_App", - "status": "Failed", - "deploymentOverview": { - "Failed": 0, - "InProgress": 0, - "Skipped": 0, - "Succeeded": 1, - "Pending": 0 - }, - "deploymentConfigName": "CodeDeployDefault.OneAtATime", - "creator": "user", - "deploymentGroupName": "WordPress_DG", - "revision": { - "revisionType": "S3", - "s3Location": { - "bundleType": "zip", - "version": "uTecLusvCB_JqHFXtfUcyfV8bEXAMPLE", - "bucket": "CodeDeployDemoBucket", - "key": "WordPressApp.zip" - } - }, - "deploymentId": "d-QA4G4F9EX", - "createTime": 1408480721.9, - "completeTime": 1408480741.822 - }, - { - "applicationName": "MyOther_App", - "status": "Failed", - "deploymentOverview": { - "Failed": 1, - "InProgress": 0, - "Skipped": 0, - "Succeeded": 0, - "Pending": 0 - }, - "deploymentConfigName": "CodeDeployDefault.OneAtATime", - "creator": "user", - "errorInformation": { - "message": "Deployment failed: Constraint default violated: No hosts succeeded.", - "code": "HEALTH_CONSTRAINTS" - }, - "deploymentGroupName": "MyOther_DG", - "revision": { - "revisionType": "S3", - "s3Location": { - "bundleType": "zip", - "eTag": "\"dd56cfd59d434b8e768f9d77fEXAMPLE\"", - "bucket": "CodeDeployDemoBucket", - "key": "MyOtherApp.zip" - } - }, - "deploymentId": "d-USUAELQEX", - "createTime": 1409764576.589, - "completeTime": 1409764596.101 - } - ] - } + { + "deploymentsInfo": [ + { + "applicationName": "WordPress_App", + "status": "Failed", + "deploymentOverview": { + "Failed": 0, + "InProgress": 0, + "Skipped": 0, + "Succeeded": 1, + "Pending": 0 + }, + "deploymentConfigName": "CodeDeployDefault.OneAtATime", + "creator": "user", + "deploymentGroupName": "WordPress_DG", + "revision": { + "revisionType": "S3", + "s3Location": { + "bundleType": "zip", + "version": "uTecLusEXAMPLEFXtfUcyfV8bEXAMPLE", + "bucket": "CodeDeployDemoBucket", + "key": "WordPressApp.zip" + } + }, + "deploymentId": "d-A1B2C3111", + "createTime": 1408480721.9, + "completeTime": 1408480741.822 + }, + { + "applicationName": "MyOther_App", + "status": "Failed", + "deploymentOverview": { + "Failed": 1, + "InProgress": 0, + "Skipped": 0, + "Succeeded": 0, + "Pending": 0 + }, + "deploymentConfigName": "CodeDeployDefault.OneAtATime", + "creator": "user", + "errorInformation": { + "message": "Deployment failed: Constraint default violated: No hosts succeeded.", + "code": "HEALTH_CONSTRAINTS" + }, + "deploymentGroupName": "MyOther_DG", + "revision": { + "revisionType": "S3", + "s3Location": { + "bundleType": "zip", + "eTag": "\"dd56cfdEXAMPLE8e768f9d77fEXAMPLE\"", + "bucket": "CodeDeployDemoBucket", + "key": "MyOtherApp.zip" + } + }, + "deploymentId": "d-A1B2C3222", + "createTime": 1409764576.589, + "completeTime": 1409764596.101 + } + ] + } diff --git a/bin/awscli/examples/deploy/batch-get-on-premises-instances.rst b/bin/awscli/examples/deploy/batch-get-on-premises-instances.rst old mode 100644 new mode 100755 index 36558813..75306215 --- a/bin/awscli/examples/deploy/batch-get-on-premises-instances.rst +++ b/bin/awscli/examples/deploy/batch-get-on-premises-instances.rst @@ -1,38 +1,36 @@ **To get information about one or more on-premises instances** -This example gets information about two on-premises instances. +The follwoing ``batch-get-on-premises-instances`` example gets information about two on-premises instances. :: -Command:: - - aws deploy batch-get-on-premises-instances --instance-names AssetTag12010298EX AssetTag23121309EX + aws deploy batch-get-on-premises-instances --instance-names AssetTag12010298EX AssetTag23121309EX Output:: - { - "instanceInfos": [ - { - "iamUserArn": "arn:aws:iam::80398EXAMPLE:user/AWS/CodeDeploy/AssetTag12010298EX", - "tags": [ - { - "Value": "CodeDeployDemo-OnPrem", - "Key": "Name" - } - ], - "instanceName": "AssetTag12010298EX", - "registerTime": 1425579465.228, - "instanceArn": "arn:aws:codedeploy:us-west-2:80398EXAMPLE:instance/AssetTag12010298EX_4IwLNI2Alh" - }, - { - "iamUserArn": "arn:aws:iam::80398EXAMPLE:user/AWS/CodeDeploy/AssetTag23121309EX", - "tags": [ - { - "Value": "CodeDeployDemo-OnPrem", - "Key": "Name" - } - ], - "instanceName": "AssetTag23121309EX", - "registerTime": 1425595585.988, - "instanceArn": "arn:aws:codedeploy:us-west-2:80398EXAMPLE:instance/AssetTag23121309EX_PomUy64Was" - } - ] - } \ No newline at end of file + { + "instanceInfos": [ + { + "iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag12010298EX", + "tags": [ + { + "Value": "CodeDeployDemo-OnPrem", + "Key": "Name" + } + ], + "instanceName": "AssetTag12010298EX", + "registerTime": 1425579465.228, + "instanceArn": "arn:aws:codedeploy:us-west-2:123456789012:instance/AssetTag12010298EX_4IwLNI2Alh" + }, + { + "iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag23121309EX", + "tags": [ + { + "Value": "CodeDeployDemo-OnPrem", + "Key": "Name" + } + ], + "instanceName": "AssetTag23121309EX", + "registerTime": 1425595585.988, + "instanceArn": "arn:aws:codedeploy:us-west-2:80398EXAMPLE:instance/AssetTag23121309EX_PomUy64Was" + } + ] + } diff --git a/bin/awscli/examples/deploy/continue-deployment.rst b/bin/awscli/examples/deploy/continue-deployment.rst new file mode 100755 index 00000000..b416be35 --- /dev/null +++ b/bin/awscli/examples/deploy/continue-deployment.rst @@ -0,0 +1,11 @@ +**To start rerouting traffic without waiting for a specified wait time to elapse.** + +The following ``continue-deployment`` example starts rerouting traffic from instances in the original environment that are ready to start shifting traffic to instances in the replacement environment. :: + + aws deploy continue-deployment \ + --deployment-d "d-A1B2C3111" \ + --deployment-wait-type "READY_WAIT" + +This command produces no output. + +For more information, see `ContinueDeployment `_ in the *AWS CodeDeploy API Reference*. diff --git a/bin/awscli/examples/deploy/create-application.rst b/bin/awscli/examples/deploy/create-application.rst old mode 100644 new mode 100755 index dcd35376..a8df3396 --- a/bin/awscli/examples/deploy/create-application.rst +++ b/bin/awscli/examples/deploy/create-application.rst @@ -1,13 +1,11 @@ **To create an application** -This example creates an application and associates it with the user's AWS account. +The following ``create-application`` example creates an application and associates it with the user's AWS account. :: -Command:: + aws deploy create-application --application-name MyOther_App - aws deploy create-application --application-name MyOther_App - Output:: - { - "applicationId": "cfd3e1f1-5744-4aee-9251-eaa25EXAMPLE" - } \ No newline at end of file + { + "applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" + } diff --git a/bin/awscli/examples/deploy/create-deployment-config.rst b/bin/awscli/examples/deploy/create-deployment-config.rst old mode 100644 new mode 100755 index 5650009f..10315aae --- a/bin/awscli/examples/deploy/create-deployment-config.rst +++ b/bin/awscli/examples/deploy/create-deployment-config.rst @@ -1,13 +1,13 @@ **To create a custom deployment configuration** -This example creates a custom deployment configuration and associates it with the user's AWS account. +The following ``create-deployment-config`` example creates a custom deployment configuration and associates it with the user's AWS account. :: -Command:: - - aws deploy create-deployment-config --deployment-config-name ThreeQuartersHealthy --minimum-healthy-hosts type=FLEET_PERCENT,value=75 + aws deploy create-deployment-config \ + --deployment-config-name ThreeQuartersHealthy \ + --minimum-healthy-hosts type=FLEET_PERCENT,value=75 Output:: - { - "deploymentConfigId": "bf6b390b-61d3-4f24-8911-a1664EXAMPLE" - } \ No newline at end of file + { + "deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" + } \ No newline at end of file diff --git a/bin/awscli/examples/deploy/create-deployment-group.rst b/bin/awscli/examples/deploy/create-deployment-group.rst old mode 100644 new mode 100755 index b9049844..1a66b615 --- a/bin/awscli/examples/deploy/create-deployment-group.rst +++ b/bin/awscli/examples/deploy/create-deployment-group.rst @@ -1,13 +1,17 @@ **To create a deployment group** -This example creates a deployment group and associates it with the specified application and the user's AWS account. +The following ``create-deployment-group`` example creates a deployment group and associates it with the specified application and the user's AWS account. :: -Command:: - - aws deploy create-deployment-group --application-name WordPress_App --auto-scaling-groups CodeDeployDemo-ASG --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name WordPress_DG --ec2-tag-filters Key=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE --service-role-arn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemoRole + aws deploy create-deployment-group \ + --application-name WordPress_App \ + --auto-scaling-groups CodeDeployDemo-ASG \ + --deployment-config-name CodeDeployDefault.OneAtATime \ + --deployment-group-name WordPress_DG \ + --ec2-tag-filters Key=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE \ + --service-role-arn arn:aws:iam::123456789012:role/CodeDeployDemoRole Output:: - { - "deploymentGroupId": "cdac3220-0e64-4d63-bb50-e68faEXAMPLE" - } \ No newline at end of file + { + "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" + } diff --git a/bin/awscli/examples/deploy/create-deployment.rst b/bin/awscli/examples/deploy/create-deployment.rst old mode 100644 new mode 100755 index d4864856..33244c7a --- a/bin/awscli/examples/deploy/create-deployment.rst +++ b/bin/awscli/examples/deploy/create-deployment.rst @@ -1,13 +1,16 @@ **To create a deployment** -This example creates a deployment and associates it with the user's AWS account. +The following ``create-deployment`` example creates a deployment and associates it with the user's AWS account. :: -Command:: - - aws deploy create-deployment --application-name WordPress_App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name WordPress_DG --description "My demo deployment" --s3-location bucket=CodeDeployDemoBucket,bundleType=zip,eTag=dd56cfd59d434b8e768f9d77fEXAMPLE,key=WordPressApp.zip + aws deploy create-deployment \ + --application-name WordPress_App \ + --deployment-config-name CodeDeployDefault.OneAtATime \ + --deployment-group-name WordPress_DG \ + --description "My demo deployment" \ + --s3-location bucket=CodeDeployDemoBucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip Output:: - { - "deploymentId": "d-N65YI7Gex" - } \ No newline at end of file + { + "deploymentId": "d-A1B2C3111" + } diff --git a/bin/awscli/examples/deploy/delete-application.rst b/bin/awscli/examples/deploy/delete-application.rst old mode 100644 new mode 100755 index ebf8d1f5..65a0c488 --- a/bin/awscli/examples/deploy/delete-application.rst +++ b/bin/awscli/examples/deploy/delete-application.rst @@ -1,11 +1,7 @@ **To delete an application** -This example deletes an application that is associated with the user's AWS account. +The following ``delete-application`` example deletes the specified application that is associated with the user's AWS account. :: -Command:: + aws deploy delete-application --application-name WordPress_App - aws deploy delete-application --application-name WordPress_App - -Output:: - - None. \ No newline at end of file +This command produces no output. \ No newline at end of file diff --git a/bin/awscli/examples/deploy/delete-deployment-config.rst b/bin/awscli/examples/deploy/delete-deployment-config.rst old mode 100644 new mode 100755 index 7ab89bac..6b67bc87 --- a/bin/awscli/examples/deploy/delete-deployment-config.rst +++ b/bin/awscli/examples/deploy/delete-deployment-config.rst @@ -1,11 +1,7 @@ **To delete a deployment configuration** -This example deletes a custom deployment configuration that is associated with the user's AWS account. +The following ``delete-deployment-config`` example deletes a custom deployment configuration that is associated with the user's AWS account. :: -Command:: + aws deploy delete-deployment-config --deployment-config-name ThreeQuartersHealthy - aws deploy delete-deployment-config --deployment-config-name ThreeQuartersHealthy - -Output:: - - None. \ No newline at end of file +This command produces no output. diff --git a/bin/awscli/examples/deploy/delete-deployment-group.rst b/bin/awscli/examples/deploy/delete-deployment-group.rst old mode 100644 new mode 100755 index 74626844..065a945b --- a/bin/awscli/examples/deploy/delete-deployment-group.rst +++ b/bin/awscli/examples/deploy/delete-deployment-group.rst @@ -1,13 +1,13 @@ **To delete a deployment group** -This example deletes a deployment group that is associated with the specified application. +The following ``delete-deployment-group`` example deletes a deployment group that is associated with the specified application. :: -Command:: - - aws deploy delete-deployment-group --application-name WordPress_App --deployment-group-name WordPress_DG + aws deploy delete-deployment-group \ + --application-name WordPress_App \ + --deployment-group-name WordPress_DG Output:: - { - "hooksNotCleanedUp": [] - } \ No newline at end of file + { + "hooksNotCleanedUp": [] + } diff --git a/bin/awscli/examples/deploy/delete-git-hub-account-token.rst b/bin/awscli/examples/deploy/delete-git-hub-account-token.rst new file mode 100755 index 00000000..35a0ab0c --- /dev/null +++ b/bin/awscli/examples/deploy/delete-git-hub-account-token.rst @@ -0,0 +1,13 @@ +**To deletes a GitHub account connection** + +The following ``delete-git-hub-account-token`` example deletes the connection of the specified GitHub account. :: + + aws deploy delete-git-hub-account-token --token-name my-github-account + +Output:: + + { + "tokenName": "my-github-account" + } + +For more information, see `DeleteGitHubAccountToken `_ in the *AWS CodeDeploy API Reference*. diff --git a/bin/awscli/examples/deploy/deregister-on-premises-instance.rst b/bin/awscli/examples/deploy/deregister-on-premises-instance.rst old mode 100644 new mode 100755 index c2d6ac89..d94aa539 --- a/bin/awscli/examples/deploy/deregister-on-premises-instance.rst +++ b/bin/awscli/examples/deploy/deregister-on-premises-instance.rst @@ -1,11 +1,7 @@ **To deregister an on-premises instance** -This example deregisters an on-premises instance with AWS CodeDeploy, but it does not delete the IAM user associated with the instance, nor does it disassociate in AWS CodeDeploy the on-premises instance tags from the instance. It also does not uninstall the AWS CodeDeploy Agent from the instance nor remove the on-premises configuration file from the instance. +The following ``deregister-on-premises-instance`` example deregisters an on-premises instance with AWS CodeDeploy, but it does not delete the IAM user associated with the instance, nor does it disassociate in AWS CodeDeploy the on-premises instance tags from the instance. It also does not uninstall the AWS CodeDeploy Agent from the instance nor remove the on-premises configuration file from the instance. :: -Command:: + aws deploy deregister-on-premises-instance --instance-name AssetTag12010298EX - aws deploy deregister-on-premises-instance --instance-name AssetTag12010298EX - -Output:: - - This command produces no output. \ No newline at end of file +This command produces no output. diff --git a/bin/awscli/examples/deploy/deregister.rst b/bin/awscli/examples/deploy/deregister.rst old mode 100644 new mode 100755 index 086372ba..91215aa1 --- a/bin/awscli/examples/deploy/deregister.rst +++ b/bin/awscli/examples/deploy/deregister.rst @@ -1,17 +1,18 @@ **To deregister an on-premises instance** -This example deregisters an on-premises instance with AWS CodeDeploy. It does not delete the IAM user that is associated with the instance. It disassociates in AWS CodeDeploy the on-premises tags from the instance. It does not uninstall the AWS CodeDeploy Agent from the instance nor remove the on-premises configuration file from the instance. +The following ``deregister`` example deregisters an on-premises instance with AWS CodeDeploy. It does not delete the IAM user that is associated with the instance. It disassociates in AWS CodeDeploy the on-premises tags from the instance. It does not uninstall the AWS CodeDeploy Agent from the instance nor remove the on-premises configuration file from the instance. :: -Command:: - - aws deploy deregister --instance-name AssetTag12010298EX --no-delete-iam-user --region us-west-2 + aws deploy deregister \ + --instance-name AssetTag12010298EX \ + --no-delete-iam-user \ + --region us-west-2 Output:: - Retrieving on-premises instance information... DONE - IamUserArn: arn:aws:iam::80398EXAMPLE:user/AWS/CodeDeploy/AssetTag12010298EX - Tags: Key=Name,Value=CodeDeployDemo-OnPrem - Removing tags from the on-premises instance... DONE - Deregistering the on-premises instance... DONE - Run the following command on the on-premises instance to uninstall the codedeploy-agent: - aws deploy uninstall \ No newline at end of file + Retrieving on-premises instance information... DONE + IamUserArn: arn:aws:iam::80398EXAMPLE:user/AWS/CodeDeploy/AssetTag12010298EX + Tags: Key=Name,Value=CodeDeployDemo-OnPrem + Removing tags from the on-premises instance... DONE + Deregistering the on-premises instance... DONE + Run the following command on the on-premises instance to uninstall the codedeploy-agent: + aws deploy uninstall diff --git a/bin/awscli/examples/deploy/get-application-revision.rst b/bin/awscli/examples/deploy/get-application-revision.rst old mode 100644 new mode 100755 index fdb04f8a..671e16ad --- a/bin/awscli/examples/deploy/get-application-revision.rst +++ b/bin/awscli/examples/deploy/get-application-revision.rst @@ -1,29 +1,29 @@ **To get information about an application revision** -This example displays information about an application revision that is associated with the specified application. +The following ``get-application-revision`` example displays information about an application revision that is associated with the specified application. :: -Command:: - - aws deploy get-application-revision --application-name WordPress_App --s3-location bucket=CodeDeployDemoBucket,bundleType=zip,eTag=dd56cfd59d434b8e768f9d77fEXAMPLE,key=WordPressApp.zip + aws deploy get-application-revision \ + --application-name WordPress_App \ + --s3-location bucket=CodeDeployDemoBucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip Output:: - { - "applicationName": "WordPress_App", - "revisionInfo": { - "description": "Application revision registered by Deployment ID: d-N65I7GEX", - "registerTime": 1411076520.009, - "deploymentGroups": "WordPress_DG", - "lastUsedTime": 1411076520.009, - "firstUsedTime": 1411076520.009 - }, - "revision": { - "revisionType": "S3", - "s3Location": { - "bundleType": "zip", - "eTag": "dd56cfd59d434b8e768f9d77fEXAMPLE", - "bucket": "CodeDeployDemoBucket", - "key": "WordPressApp.zip" - } - } - } \ No newline at end of file + { + "applicationName": "WordPress_App", + "revisionInfo": { + "description": "Application revision registered by Deployment ID: d-A1B2C3111", + "registerTime": 1411076520.009, + "deploymentGroups": "WordPress_DG", + "lastUsedTime": 1411076520.009, + "firstUsedTime": 1411076520.009 + }, + "revision": { + "revisionType": "S3", + "s3Location": { + "bundleType": "zip", + "eTag": "dd56cfdEXAMPLE8e768f9d77fEXAMPLE", + "bucket": "CodeDeployDemoBucket", + "key": "WordPressApp.zip" + } + } + } diff --git a/bin/awscli/examples/deploy/get-application.rst b/bin/awscli/examples/deploy/get-application.rst old mode 100644 new mode 100755 index ef4ad90e..d645219b --- a/bin/awscli/examples/deploy/get-application.rst +++ b/bin/awscli/examples/deploy/get-application.rst @@ -1,18 +1,16 @@ **To get information about an application** -This example displays information about an application that is associated with the user's AWS account. +The following ``get-application`` example displays information about an application that is associated with the user's AWS account. :: -Command:: - - aws deploy get-application --application-name WordPress_App + aws deploy get-application --application-name WordPress_App Output:: - { - "application": { - "applicationName": "WordPress_App", - "applicationId": "d9dd6993-f171-44fa-a811-211e4EXAMPLE", - "createTime": 1407878168.078, - "linkedToGitHub": false - } - } \ No newline at end of file + { + "application": { + "applicationName": "WordPress_App", + "applicationId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "createTime": 1407878168.078, + "linkedToGitHub": false + } + } diff --git a/bin/awscli/examples/deploy/get-deployment-config.rst b/bin/awscli/examples/deploy/get-deployment-config.rst old mode 100644 new mode 100755 index d0ea9632..0e0c8269 --- a/bin/awscli/examples/deploy/get-deployment-config.rst +++ b/bin/awscli/examples/deploy/get-deployment-config.rst @@ -1,21 +1,19 @@ **To get information about a deployment configuration** -This example displays information about a deployment configuration that is associated with the user's AWS account. +The following ``get-deployment-config`` example displays information about a deployment configuration that is associated with the user's AWS account. :: -Command:: - - aws deploy get-deployment-config --deployment-config-name ThreeQuartersHealthy + aws deploy get-deployment-config --deployment-config-name ThreeQuartersHealthy Output:: - { - "deploymentConfigInfo": { - "deploymentConfigId": "bf6b390b-61d3-4f24-8911-a1664EXAMPLE", - "minimumHealthyHosts": { - "type": "FLEET_PERCENT", - "value": 75 - }, - "createTime": 1411081164.379, - "deploymentConfigName": "ThreeQuartersHealthy" - } - } \ No newline at end of file + { + "deploymentConfigInfo": { + "deploymentConfigId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "minimumHealthyHosts": { + "type": "FLEET_PERCENT", + "value": 75 + }, + "createTime": 1411081164.379, + "deploymentConfigName": "ThreeQuartersHealthy" + } + } diff --git a/bin/awscli/examples/deploy/get-deployment-group.rst b/bin/awscli/examples/deploy/get-deployment-group.rst old mode 100644 new mode 100755 index 75d84dea..fbb7853d --- a/bin/awscli/examples/deploy/get-deployment-group.rst +++ b/bin/awscli/examples/deploy/get-deployment-group.rst @@ -1,29 +1,29 @@ **To view information about a deployment group** -This example displays information about a deployment group that is associated with the specified application. +The following ``get-deployment-group`` example displays information about a deployment group that is associated with the specified application. :: -Command:: - - aws deploy get-deployment-group --application-name WordPress_App --deployment-group-name WordPress_DG + aws deploy get-deployment-group \ + --application-name WordPress_App \ + --deployment-group-name WordPress_DG Output:: - { - "deploymentGroupInfo": { - "applicationName": "WordPress_App", - "autoScalingGroups": [ - "CodeDeployDemo-ASG" - ], - "deploymentConfigName": "CodeDeployDefault.OneAtATime", - "ec2TagFilters": [ - { - "Type": "KEY_AND_VALUE", - "Value": "CodeDeployDemo", - "Key": "Name" - } - ], - "deploymentGroupId": "cdac3220-0e64-4d63-bb50-e68faEXAMPLE", - "serviceRoleArn": "arn:aws:iam::80398EXAMPLE:role/CodeDeployDemoRole", - "deploymentGroupName": "WordPress_DG" - } - } \ No newline at end of file + { + "deploymentGroupInfo": { + "applicationName": "WordPress_App", + "autoScalingGroups": [ + "CodeDeployDemo-ASG" + ], + "deploymentConfigName": "CodeDeployDefault.OneAtATime", + "ec2TagFilters": [ + { + "Type": "KEY_AND_VALUE", + "Value": "CodeDeployDemo", + "Key": "Name" + } + ], + "deploymentGroupId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "serviceRoleArn": "arn:aws:iam::123456789012:role/CodeDeployDemoRole", + "deploymentGroupName": "WordPress_DG" + } + } diff --git a/bin/awscli/examples/deploy/get-deployment-instance.rst b/bin/awscli/examples/deploy/get-deployment-instance.rst old mode 100644 new mode 100755 index a48cd886..bdc91ffe --- a/bin/awscli/examples/deploy/get-deployment-instance.rst +++ b/bin/awscli/examples/deploy/get-deployment-instance.rst @@ -1,60 +1,58 @@ **To get information about a deployment instance** -This example displays information about a deployment instance that is associated with the specified deployment. +The following ``get-deployment-instance`` example displays information about a deployment instance that is associated with the specified deployment. :: -Command:: - - aws deploy get-deployment-instance --deployment-id d-QA4G4F9EX --instance-id i-902e9fEX + aws deploy get-deployment-instance --deployment-id d-QA4G4F9EX --instance-id i-902e9fEX Output:: - { - "instanceSummary": { - "instanceId": "arn:aws:ec2:us-east-1:80398EXAMPLE:instance/i-902e9fEX", - "lifecycleEvents": [ - { - "status": "Succeeded", - "endTime": 1408480726.569, - "startTime": 1408480726.437, - "lifecycleEventName": "ApplicationStop" - }, - { - "status": "Succeeded", - "endTime": 1408480728.016, - "startTime": 1408480727.665, - "lifecycleEventName": "DownloadBundle" - }, - { - "status": "Succeeded", - "endTime": 1408480729.744, - "startTime": 1408480729.125, - "lifecycleEventName": "BeforeInstall" - }, - { - "status": "Succeeded", - "endTime": 1408480730.979, - "startTime": 1408480730.844, - "lifecycleEventName": "Install" - }, - { - "status": "Failed", - "endTime": 1408480732.603, - "startTime": 1408480732.1, - "lifecycleEventName": "AfterInstall" - }, - { - "status": "Skipped", - "endTime": 1408480732.606, - "lifecycleEventName": "ApplicationStart" - }, - { - "status": "Skipped", - "endTime": 1408480732.606, - "lifecycleEventName": "ValidateService" - } - ], - "deploymentId": "d-QA4G4F9EX", - "lastUpdatedAt": 1408480733.152, - "status": "Failed" - } - } \ No newline at end of file + { + "instanceSummary": { + "instanceId": "arn:aws:ec2:us-east-1:80398EXAMPLE:instance/i-902e9fEX", + "lifecycleEvents": [ + { + "status": "Succeeded", + "endTime": 1408480726.569, + "startTime": 1408480726.437, + "lifecycleEventName": "ApplicationStop" + }, + { + "status": "Succeeded", + "endTime": 1408480728.016, + "startTime": 1408480727.665, + "lifecycleEventName": "DownloadBundle" + }, + { + "status": "Succeeded", + "endTime": 1408480729.744, + "startTime": 1408480729.125, + "lifecycleEventName": "BeforeInstall" + }, + { + "status": "Succeeded", + "endTime": 1408480730.979, + "startTime": 1408480730.844, + "lifecycleEventName": "Install" + }, + { + "status": "Failed", + "endTime": 1408480732.603, + "startTime": 1408480732.1, + "lifecycleEventName": "AfterInstall" + }, + { + "status": "Skipped", + "endTime": 1408480732.606, + "lifecycleEventName": "ApplicationStart" + }, + { + "status": "Skipped", + "endTime": 1408480732.606, + "lifecycleEventName": "ValidateService" + } + ], + "deploymentId": "d-QA4G4F9EX", + "lastUpdatedAt": 1408480733.152, + "status": "Failed" + } + } diff --git a/bin/awscli/examples/deploy/get-deployment-target.rst b/bin/awscli/examples/deploy/get-deployment-target.rst new file mode 100755 index 00000000..81258b0f --- /dev/null +++ b/bin/awscli/examples/deploy/get-deployment-target.rst @@ -0,0 +1,110 @@ +**To return information about a deployment target** + +The following ``get-deployment-target`` example returns information about a deployment target that is associated with the specified deployment. :: + + aws deploy get-deployment-target \ + --deployment-id "d-A1B2C3111" \ + --target-id "i-a1b2c3d4e5f611111" + +Output:: + + { + "deploymentTarget": { + "deploymentTargetType": "InstanceTarget", + "instanceTarget": { + "lastUpdatedAt": 1556918687.504, + "targetId": "i-a1b2c3d4e5f611111", + "targetArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-a1b2c3d4e5f611111", + "status": "Succeeded", + "lifecycleEvents": [ + { + "status": "Succeeded", + "diagnostics": { + "errorCode": "Success", + "message": "Succeeded", + "logTail": "", + "scriptName": "" + }, + "lifecycleEventName": "ApplicationStop", + "startTime": 1556918592.162, + "endTime": 1556918592.247 + }, + { + "status": "Succeeded", + "diagnostics": { + "errorCode": "Success", + "message": "Succeeded", + "logTail": "", + "scriptName": "" + }, + "lifecycleEventName": "DownloadBundle", + "startTime": 1556918593.193, + "endTime": 1556918593.981 + }, + { + "status": "Succeeded", + "diagnostics": { + "errorCode": "Success", + "message": "Succeeded", + "logTail": "", + "scriptName": "" + }, + "lifecycleEventName": "BeforeInstall", + "startTime": 1556918594.805, + "endTime": 1556918681.807 + }, + { + "status": "Succeeded", + "diagnostics": { + "errorCode": "Success", + "message": "Succeeded", + "logTail": "", + "scriptName": "" + }, + "lifecycleEventName": "Install", + "startTime": 1556918682.696, + "endTime": 1556918683.005 + }, + { + "status": "Succeeded", + "diagnostics": { + "errorCode": "Success", + "message": "Succeeded", + "logTail": "", + "scriptName": "" + }, + "lifecycleEventName": "AfterInstall", + "startTime": 1556918684.135, + "endTime": 1556918684.216 + }, + { + "status": "Succeeded", + "diagnostics": { + "errorCode": "Success", + "message": "Succeeded", + "logTail": "", + "scriptName": "" + }, + "lifecycleEventName": "ApplicationStart", + "startTime": 1556918685.211, + "endTime": 1556918685.295 + }, + { + "status": "Succeeded", + "diagnostics": { + "errorCode": "Success", + "message": "Succeeded", + "logTail": "", + "scriptName": "" + }, + "lifecycleEventName": "ValidateService", + "startTime": 1556918686.65, + "endTime": 1556918686.747 + } + ], + "deploymentId": "d-A1B2C3111" + } + } + } + +For more information, see `GetDeploymentTarget `_ in the *AWS CodeDeploy API Reference*. diff --git a/bin/awscli/examples/deploy/get-deployment.rst b/bin/awscli/examples/deploy/get-deployment.rst old mode 100644 new mode 100755 index 3a512d13..8bdc8255 --- a/bin/awscli/examples/deploy/get-deployment.rst +++ b/bin/awscli/examples/deploy/get-deployment.rst @@ -1,40 +1,38 @@ **To get information about a deployment** -This example displays information about a deployment that is associated with the user's AWS account. +The following ``get-deployment`` example displays information about a deployment that is associated with the user's AWS account. :: -Command:: - - aws deploy get-deployment --deployment-id d-USUAELQEX + aws deploy get-deployment --deployment-id d-A1B2C3123 Output:: - { - "deploymentInfo": { - "applicationName": "WordPress_App", - "status": "Succeeded", - "deploymentOverview": { - "Failed": 0, - "InProgress": 0, - "Skipped": 0, - "Succeeded": 1, - "Pending": 0 - }, - "deploymentConfigName": "CodeDeployDefault.OneAtATime", - "creator": "user", - "description": "My WordPress app deployment", - "revision": { - "revisionType": "S3", - "s3Location": { - "bundleType": "zip", - "eTag": "\"dd56cfd59d434b8e768f9d77fEXAMPLE\"", - "bucket": "CodeDeployDemoBucket", - "key": "WordPressApp.zip" - } - }, - "deploymentId": "d-USUAELQEX", - "deploymentGroupName": "WordPress_DG", - "createTime": 1409764576.589, - "completeTime": 1409764596.101, - "ignoreApplicationStopFailures": false - } - } \ No newline at end of file + { + "deploymentInfo": { + "applicationName": "WordPress_App", + "status": "Succeeded", + "deploymentOverview": { + "Failed": 0, + "InProgress": 0, + "Skipped": 0, + "Succeeded": 1, + "Pending": 0 + }, + "deploymentConfigName": "CodeDeployDefault.OneAtATime", + "creator": "user", + "description": "My WordPress app deployment", + "revision": { + "revisionType": "S3", + "s3Location": { + "bundleType": "zip", + "eTag": "\"dd56cfdEXAMPLE8e768f9d77fEXAMPLE\"", + "bucket": "CodeDeployDemoBucket", + "key": "WordPressApp.zip" + } + }, + "deploymentId": "d-A1B2C3123", + "deploymentGroupName": "WordPress_DG", + "createTime": 1409764576.589, + "completeTime": 1409764596.101, + "ignoreApplicationStopFailures": false + } + } diff --git a/bin/awscli/examples/deploy/get-on-premises-instance.rst b/bin/awscli/examples/deploy/get-on-premises-instance.rst old mode 100644 new mode 100755 index 2461dc92..6b8520a8 --- a/bin/awscli/examples/deploy/get-on-premises-instance.rst +++ b/bin/awscli/examples/deploy/get-on-premises-instance.rst @@ -1,24 +1,22 @@ **To get information about an on-premises instance** -This example gets information about an on-premises instance. +The following ``get-on-premises-instance`` example retrieves information about the specified on-premises instance. :: -Command:: - - aws deploy get-on-premises-instance --instance-name AssetTag12010298EX + aws deploy get-on-premises-instance --instance-name AssetTag12010298EX Output:: - { - "instanceInfo": { - "iamUserArn": "arn:aws:iam::80398EXAMPLE:user/AWS/CodeDeploy/AssetTag12010298EX", - "tags": [ - { - "Value": "CodeDeployDemo-OnPrem", - "Key": "Name" - } - ], - "instanceName": "AssetTag12010298EX", - "registerTime": 1425579465.228, - "instanceArn": "arn:aws:codedeploy:us-east-1:80398EXAMPLE:instance/AssetTag12010298EX_4IwLNI2Alh" - } - } \ No newline at end of file + { + "instanceInfo": { + "iamUserArn": "arn:aws:iam::123456789012:user/AWS/CodeDeploy/AssetTag12010298EX", + "tags": [ + { + "Value": "CodeDeployDemo-OnPrem", + "Key": "Name" + } + ], + "instanceName": "AssetTag12010298EX", + "registerTime": 1425579465.228, + "instanceArn": "arn:aws:codedeploy:us-east-1:123456789012:instance/AssetTag12010298EX_4IwLNI2Alh" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/deploy/install.rst b/bin/awscli/examples/deploy/install.rst old mode 100644 new mode 100755 index 9a015e0f..8696e5d2 --- a/bin/awscli/examples/deploy/install.rst +++ b/bin/awscli/examples/deploy/install.rst @@ -1,13 +1,14 @@ **To install an on-premises instance** -This example copies the on-premises configuration file from the specified location on the instance to the location on the instance that the AWS CodeDeploy Agent expects to find it. It also installs the AWS CodeDeploy Agent on the instance. It does not create any IAM user, nor register the on-premises instance with AWS CodeDeploy, nor associate any on-premises instance tags in AWS CodeDeploy for the instance. - -Command:: - - aws deploy install --override-config --config-file C:\temp\codedeploy.onpremises.yml --region us-west-2 --agent-installer s3://aws-codedeploy-us-west-2/latest/codedeploy-agent.msi +The following ``install`` example copies the on-premises configuration file from the specified location on the instance to the location on the instance that the AWS CodeDeploy Agent expects to find it. It also installs the AWS CodeDeploy Agent on the instance. It does not create any IAM user, nor register the on-premises instance with AWS CodeDeploy, nor associate any on-premises instance tags in AWS CodeDeploy for the instance. :: + aws deploy install \ + --override-config \ + --config-file C:\temp\codedeploy.onpremises.yml \ + --region us-west-2 \ + --agent-installer s3://aws-codedeploy-us-west-2/latest/codedeploy-agent.msi Output:: - Creating the on-premises instance configuration file... DONE - Installing the AWS CodeDeploy Agent... DONE \ No newline at end of file + Creating the on-premises instance configuration file... DONE + Installing the AWS CodeDeploy Agent... DONE diff --git a/bin/awscli/examples/deploy/list-application-revisions.rst b/bin/awscli/examples/deploy/list-application-revisions.rst old mode 100644 new mode 100755 index 81068a17..fc199fd1 --- a/bin/awscli/examples/deploy/list-application-revisions.rst +++ b/bin/awscli/examples/deploy/list-application-revisions.rst @@ -1,32 +1,36 @@ **To get information about application revisions** -This example displays information about all application revisions that are associated with the specified application. +The following ``list-application-revisions`` example displays information about all application revisions that are associated with the specified application. :: -Command:: - - aws deploy list-application-revisions --application-name WordPress_App --s-3-bucket CodeDeployDemoBucket --deployed exclude --s-3-key-prefix WordPress_ --sort-by lastUsedTime --sort-order descending + aws deploy list-application-revisions \ + --application-name WordPress_App \ + --s-3-bucket CodeDeployDemoBucket \ + --deployed exclude \ + --s-3-key-prefix WordPress_ \ + --sort-by lastUsedTime \ + --sort-order descending Output:: - { - "revisions": [ - { - "revisionType": "S3", - "s3Location": { - "version": "uTecLusvCB_JqHFXtfUcyfV8bEXAMPLE", - "bucket": "CodeDeployDemoBucket", - "key": "WordPress_App.zip", - "bundleType": "zip" - } - }, - { - "revisionType": "S3", - "s3Location": { - "version": "tMk.UxgDpMEVb7V187ZM6wVAWEXAMPLE", - "bucket": "CodeDeployDemoBucket", - "key": "WordPress_App_2-0.zip", - "bundleType": "zip" - } - } - ] - } + { + "revisions": [ + { + "revisionType": "S3", + "s3Location": { + "version": "uTecLusvCB_JqHFXtfUcyfV8bEXAMPLE", + "bucket": "CodeDeployDemoBucket", + "key": "WordPress_App.zip", + "bundleType": "zip" + } + }, + { + "revisionType": "S3", + "s3Location": { + "version": "tMk.UxgDpMEVb7V187ZM6wVAWEXAMPLE", + "bucket": "CodeDeployDemoBucket", + "key": "WordPress_App_2-0.zip", + "bundleType": "zip" + } + } + ] + } diff --git a/bin/awscli/examples/deploy/list-applications.rst b/bin/awscli/examples/deploy/list-applications.rst old mode 100644 new mode 100755 index cf8c7a7c..fb169bdc --- a/bin/awscli/examples/deploy/list-applications.rst +++ b/bin/awscli/examples/deploy/list-applications.rst @@ -1,16 +1,14 @@ **To get information about applications** -This example displays information about all applications that are associated with the user's AWS account. +The following ``list-applications`` example displays information about all applications that are associated with the user's AWS account. :: -Command:: - - aws deploy list-applications + aws deploy list-applications Output:: - { - "applications": [ - "WordPress_App", - "MyOther_App" - ] - } \ No newline at end of file + { + "applications": [ + "WordPress_App", + "MyOther_App" + ] + } diff --git a/bin/awscli/examples/deploy/list-deployment-configs.rst b/bin/awscli/examples/deploy/list-deployment-configs.rst old mode 100644 new mode 100755 index f7e99ab3..0fbb6cbd --- a/bin/awscli/examples/deploy/list-deployment-configs.rst +++ b/bin/awscli/examples/deploy/list-deployment-configs.rst @@ -1,18 +1,16 @@ **To get information about deployment configurations** -This example displays information about all deployment configurations that are associated with the user's AWS account. +The following ``list-deployment-configs`` example displays information about all deployment configurations that are associated with the user's AWS account. :: -Command:: - - aws deploy list-deployment-configs + aws deploy list-deployment-configs Output:: - { - "deploymentConfigsList": [ - "ThreeQuartersHealthy", - "CodeDeployDefault.AllAtOnce", - "CodeDeployDefault.HalfAtATime", - "CodeDeployDefault.OneAtATime" - ] - } \ No newline at end of file + { + "deploymentConfigsList": [ + "ThreeQuartersHealthy", + "CodeDeployDefault.AllAtOnce", + "CodeDeployDefault.HalfAtATime", + "CodeDeployDefault.OneAtATime" + ] + } diff --git a/bin/awscli/examples/deploy/list-deployment-groups.rst b/bin/awscli/examples/deploy/list-deployment-groups.rst old mode 100644 new mode 100755 index de612e0b..9b19b319 --- a/bin/awscli/examples/deploy/list-deployment-groups.rst +++ b/bin/awscli/examples/deploy/list-deployment-groups.rst @@ -1,17 +1,15 @@ **To get information about deployment groups** -This example displays information about all deployment groups that are associated with the specified application. +The following ``list-deployment-groups`` example displays information about all deployment groups that are associated with the specified application. :: -Command:: - - aws deploy list-deployment-groups --application-name WordPress_App + aws deploy list-deployment-groups --application-name WordPress_App Output:: - { - "applicationName": "WordPress_App", - "deploymentGroups": [ - "WordPress_DG", - "WordPress_Beta_DG" - ] - } \ No newline at end of file + { + "applicationName": "WordPress_App", + "deploymentGroups": [ + "WordPress_DG", + "WordPress_Beta_DG" + ] + } diff --git a/bin/awscli/examples/deploy/list-deployment-instances.rst b/bin/awscli/examples/deploy/list-deployment-instances.rst old mode 100644 new mode 100755 index a576abe9..f78e457f --- a/bin/awscli/examples/deploy/list-deployment-instances.rst +++ b/bin/awscli/examples/deploy/list-deployment-instances.rst @@ -1,16 +1,16 @@ **To get information about deployment instances** -This example displays information about all deployment instances that are associated with the specified deployment. +The following ``list-deployment-instances`` example displays information about all deployment instances that are associated with the specified deployment. :: -Command:: - - aws deploy list-deployment-instances --deployment-id d-9DI6I4EX --instance-status-filter Succeeded + aws deploy list-deployment-instances \ + --deployment-id d-A1B2C3111 \ + --instance-status-filter Succeeded Output:: - { - "instancesList": [ - "i-8c4490EX", - "i-7d5389EX" - ] - } \ No newline at end of file + { + "instancesList": [ + "i-EXAMPLE11", + "i-EXAMPLE22" + ] + } diff --git a/bin/awscli/examples/deploy/list-deployment-targets.rst b/bin/awscli/examples/deploy/list-deployment-targets.rst new file mode 100755 index 00000000..ee26a7eb --- /dev/null +++ b/bin/awscli/examples/deploy/list-deployment-targets.rst @@ -0,0 +1,17 @@ +**To retrieve a list of target IDs that are associated with a deployment** + +The following ``list-deployment-targets`` example retrieves a list of target IDs associated with deployments that have a status of "Failed" or "InProgress." :: + + aws deploy list-deployment-targets \ + --deployment-id "d-A1B2C3111" \ + --target-filters "{\"TargetStatus\":[\"Failed\",\"InProgress\"]}" + +Output:: + + { + "targetIds": [ + "i-0f1558aaf90e5f1f9" + ] + } + +For more information, see `ListDeploymentTargets `_ in the *AWS CodeDeploy API Reference*. diff --git a/bin/awscli/examples/deploy/list-deployments.rst b/bin/awscli/examples/deploy/list-deployments.rst old mode 100644 new mode 100755 index 54077fac..7cf538a1 --- a/bin/awscli/examples/deploy/list-deployments.rst +++ b/bin/awscli/examples/deploy/list-deployments.rst @@ -1,17 +1,19 @@ **To get information about deployments** -This example displays information about all deployments that are associated with the specified application and deployment group. +The follwoing ``list-deployments`` example displays information about all deployments that are associated with the specified application and deployment group. :: -Command:: - - aws deploy list-deployments --application-name WordPress_App --create-time-range start=2014-08-19T00:00:00,end=2014-08-20T00:00:00 --deployment-group-name WordPress_DG --include-only-statuses Failed + aws deploy list-deployments \ + --application-name WordPress_App \ + --create-time-range start=2014-08-19T00:00:00,end=2014-08-20T00:00:00 \ + --deployment-group-name WordPress_DG \ + --include-only-statuses Failed Output:: - { - "deployments": [ - "d-QA4G4F9EX", - "d-1MVNYOEEX", - "d-WEWRE8BEX" - ] - } \ No newline at end of file + { + "deployments": [ + "d-EXAMPLE11", + "d-EXAMPLE22", + "d-EXAMPLE33" + ] + } \ No newline at end of file diff --git a/bin/awscli/examples/deploy/list-git-hub-account-token-names.rst b/bin/awscli/examples/deploy/list-git-hub-account-token-names.rst new file mode 100755 index 00000000..dc7aa2d0 --- /dev/null +++ b/bin/awscli/examples/deploy/list-git-hub-account-token-names.rst @@ -0,0 +1,17 @@ +**To lists the names of stored connections to GitHub accounts** + +The following ``list-git-hub-account-token-names`` example lists the names of the stored connections to GitHub accounts for the current AWS user. :: + + aws deploy list-git-hub-account-token-names + +Output:: + + { + "tokenNameList": [ + "my-first-token", + "my-second-token", + "my-third-token" + ] + } + +For more information, see `ListGitHubAccountTokenNames `_ in the *AWS CodeDeploy API Reference*. diff --git a/bin/awscli/examples/deploy/list-on-premises-instances.rst b/bin/awscli/examples/deploy/list-on-premises-instances.rst old mode 100644 new mode 100755 index 5c2a371c..3b5a4548 --- a/bin/awscli/examples/deploy/list-on-premises-instances.rst +++ b/bin/awscli/examples/deploy/list-on-premises-instances.rst @@ -1,15 +1,15 @@ **To get information about one or more on-premises instances** -This example gets a list of available on-premises instance names for instances that are registered in AWS CodeDeploy and also have the specified on-premises instance tag associated in AWS CodeDeploy with the instance. +The following ``list-on-premises-instances`` example retrieves a list of available on-premises instance names for instances that are registered in AWS CodeDeploy and also have the specified on-premises instance tag associated in AWS CodeDeploy with the instance. :: -Command:: - - aws deploy list-on-premises-instances --registration-status Registered --tag-filters Key=Name,Value=CodeDeployDemo-OnPrem,Type=KEY_AND_VALUE + aws deploy list-on-premises-instances \ + --registration-status Registered \ + --tag-filters Key=Name,Value=CodeDeployDemo-OnPrem,Type=KEY_AND_VALUE Output:: - { - "instanceNames": [ - "AssetTag12010298EX" - ] - } \ No newline at end of file + { + "instanceNames": [ + "AssetTag12010298EX" + ] + } diff --git a/bin/awscli/examples/deploy/push.rst b/bin/awscli/examples/deploy/push.rst old mode 100644 new mode 100755 index 01409408..ea30dc58 --- a/bin/awscli/examples/deploy/push.rst +++ b/bin/awscli/examples/deploy/push.rst @@ -1,14 +1,15 @@ **To bundle and deploy an AWS CodeDeploy compatible application revision to Amazon S3** -This example bundles and deploys an application revision to Amazon S3 and then associates the application revision with the specified application. +The following ``push`` example bundles and deploys an application revision to Amazon S3 and then associates the application revision with the specified application. :: -Use the output of the push command to create a deployment that uses the uploaded application revision. + aws deploy push \ + --application-name WordPress_App \ + --description "This is my deployment" \ + --ignore-hidden-files \ + --s3-location s3://CodeDeployDemoBucket/WordPressApp.zip \ + --source /tmp/MyLocalDeploymentFolder/ -Command:: +The output describes how to use the ``create-deployment`` command to create a deployment that uses the uploaded application revision. :: - aws deploy push --application-name WordPress_App --description "This is my deployment" --ignore-hidden-files --s3-location s3://CodeDeployDemoBucket/WordPressApp.zip --source /tmp/MyLocalDeploymentFolder/ - -Output:: - - To deploy with this revision, run: - aws deploy create-deployment --application-name WordPress_App --deployment-config-name --deployment-group-name --s3-location bucket=CodeDeployDemoBucket,key=WordPressApp.zip,bundleType=zip,eTag="cecc9b8a08eac650a6e71fdb88EXAMPLE",version=LFsJAUd_2J4VWXfvKtvi79L8EXAMPLE \ No newline at end of file + To deploy with this revision, run: + aws deploy create-deployment --application-name WordPress_App --deployment-config-name --deployment-group-name --s3-location bucket=CodeDeployDemoBucket,key=WordPressApp.zip,bundleType=zip,eTag="cecc9b8EXAMPLE50a6e71fdb88EXAMPLE",version=LFsJAUdEXAMPLEfvKtvi79L8EXAMPLE \ No newline at end of file diff --git a/bin/awscli/examples/deploy/register-application-revision.rst b/bin/awscli/examples/deploy/register-application-revision.rst old mode 100644 new mode 100755 index 2fb79bee..49a03130 --- a/bin/awscli/examples/deploy/register-application-revision.rst +++ b/bin/awscli/examples/deploy/register-application-revision.rst @@ -1,11 +1,10 @@ **To register information about an already-uploaded application revision** -This example registers information about an already-uploaded application revision in Amazon S3 with AWS CodeDeploy. +The following ``register-application-revision`` example registers information about an already-uploaded application revision stored in Amazon S3 with AWS CodeDeploy. :: -Command:: + aws deploy register-application-revision \ + --application-name WordPress_App \ + --description "Revised WordPress application" \ + --s3-location bucket=CodeDeployDemoBucket,key=RevisedWordPressApp.zip,bundleType=zip,eTag=cecc9b8a08eac650a6e71fdb88EXAMPLE - aws deploy register-application-revision --application-name WordPress_App --description "Revised WordPress application" --s3-location bucket=CodeDeployDemoBucket,key=RevisedWordPressApp.zip,bundleType=zip,eTag=cecc9b8a08eac650a6e71fdb88EXAMPLE - -Output:: - - None. \ No newline at end of file +This command produces no output. diff --git a/bin/awscli/examples/deploy/register-on-premises-instance.rst b/bin/awscli/examples/deploy/register-on-premises-instance.rst old mode 100644 new mode 100755 index b22a3498..a2e36cfa --- a/bin/awscli/examples/deploy/register-on-premises-instance.rst +++ b/bin/awscli/examples/deploy/register-on-premises-instance.rst @@ -1,11 +1,9 @@ **To register an on-premises instance** -This example registers an on-premises instance with AWS CodeDeploy. It does not create the specified IAM user, nor does it associate in AWS CodeDeploy any on-premises instances tags with the registered instance. +The following ``register-on-premises-instance`` example registers an on-premises instance with AWS CodeDeploy. It does not create the specified IAM user, nor does it associate in AWS CodeDeploy any on-premises instances tags with the registered instance. :: -Command:: + aws deploy register-on-premises-instance \ + --instance-name AssetTag12010298EX \ + --iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser-OnPrem - aws deploy register-on-premises-instance --instance-name AssetTag12010298EX --iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser-OnPrem - -Output:: - - This command produces no output. \ No newline at end of file +This command produces no output. diff --git a/bin/awscli/examples/deploy/register.rst b/bin/awscli/examples/deploy/register.rst old mode 100644 new mode 100755 index 5982ca0f..5bea0080 --- a/bin/awscli/examples/deploy/register.rst +++ b/bin/awscli/examples/deploy/register.rst @@ -1,14 +1,16 @@ **To register an on-premises instance** -This example registers an on-premises instance with AWS CodeDeploy, associates in AWS CodeDeploy the specified on-premises instance tag with the registered instance, and creates an on-premises configuration file that can be copied to the instance. It does not create the IAM user, nor does it install the AWS CodeDeploy Agent on the instance. +The following ``register`` example registers an on-premises instance with AWS CodeDeploy, associates in AWS CodeDeploy the specified on-premises instance tag with the registered instance, and creates an on-premises configuration file that can be copied to the instance. It does not create the IAM user, nor does it install the AWS CodeDeploy Agent on the instance. :: -Command:: - - aws deploy register --instance-name AssetTag12010298EX --iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployUser-OnPrem --tags Key=Name,Value=CodeDeployDemo-OnPrem --region us-west-2 + aws deploy register \ + --instance-name AssetTag12010298EX \ + --iam-user-arn arn:aws:iam::80398EXAMPLE:user/CodeDeployUser-OnPrem \ + --tags Key=Name,Value=CodeDeployDemo-OnPrem \ + --region us-west-2 Output:: - Registering the on-premises instance... DONE - Adding tags to the on-premises instance... DONE - Copy the on-premises configuration file named codedeploy.onpremises.yml to the on-premises instance, and run the following command on the on-premises instance to install and configure the AWS CodeDeploy Agent: - aws deploy install --config-file codedeploy.onpremises.yml \ No newline at end of file + Registering the on-premises instance... DONE + Adding tags to the on-premises instance... DONE + Copy the on-premises configuration file named codedeploy.onpremises.yml to the on-premises instance, and run the following command on the on-premises instance to install and configure the AWS CodeDeploy Agent: + aws deploy install --config-file codedeploy.onpremises.yml diff --git a/bin/awscli/examples/deploy/remove-tags-from-on-premises-instances.rst b/bin/awscli/examples/deploy/remove-tags-from-on-premises-instances.rst old mode 100644 new mode 100755 index 75cdf206..a7ab7659 --- a/bin/awscli/examples/deploy/remove-tags-from-on-premises-instances.rst +++ b/bin/awscli/examples/deploy/remove-tags-from-on-premises-instances.rst @@ -1,11 +1,9 @@ **To remove tags from one or more on-premises instances** -This example disassociates the same on-premises tag in AWS CodeDeploy from the two specified on-premises instances. It does not deregister the on-premises instances in AWS CodeDeploy, nor uninstall the AWS CodeDeploy Agent from the instance, nor remove the on-premises configuration file from the instances, nor delete the IAM users that are associated with the instances. +The following ``remove-tags-from-on-premises-instances`` example disassociates the specified on-premises tags in AWS CodeDeploy from on-premises instances. It does not deregister the on-premises instances in AWS CodeDeploy, nor uninstall the AWS CodeDeploy Agent from the instance, nor remove the on-premises configuration file from the instances, nor delete the IAM users that are associated with the instances. :: -Command:: + aws deploy remove-tags-from-on-premises-instances \ + --instance-names AssetTag12010298EX AssetTag23121309EX \ + --tags Key=Name,Value=CodeDeployDemo-OnPrem - aws deploy remove-tags-from-on-premises-instances --instance-names AssetTag12010298EX AssetTag23121309EX --tags Key=Name,Value=CodeDeployDemo-OnPrem - -Output:: - - This command produces no output. \ No newline at end of file +This command produces no output. diff --git a/bin/awscli/examples/deploy/stop-deployment.rst b/bin/awscli/examples/deploy/stop-deployment.rst old mode 100644 new mode 100755 index 1079e618..ad13a7fc --- a/bin/awscli/examples/deploy/stop-deployment.rst +++ b/bin/awscli/examples/deploy/stop-deployment.rst @@ -1,14 +1,12 @@ **To attempt to stop a deployment** -This example attempts to stop an in-progress deployment that is associated with the user's AWS account. +The following ``stop-deployment`` example attempts to stop an in-progress deployment that is associated with the user's AWS account. -Command:: - - aws deploy stop-deployment --deployment-id d-8365D4OEX + aws deploy stop-deployment --deployment-id d-A1B2C3111 Output:: - { - "status": "Succeeded", - "statusMessage": "No more commands will be scheduled for execution in the deployment instances" - } \ No newline at end of file + { + "status": "Succeeded", + "statusMessage": "No more commands will be scheduled for execution in the deployment instances" + } diff --git a/bin/awscli/examples/deploy/uninstall.rst b/bin/awscli/examples/deploy/uninstall.rst old mode 100644 new mode 100755 index 649f4702..b53da214 --- a/bin/awscli/examples/deploy/uninstall.rst +++ b/bin/awscli/examples/deploy/uninstall.rst @@ -1,11 +1,7 @@ **To uninstall an on-premises instance** -This example uninstalls the AWS CodeDeploy Agent from the on-premises instance, and it removes the on-premises configuration file from the instance. It does not deregister the instance in AWS CodeDeploy, nor disassociate any on-premises instance tags in AWS CodeDeploy from the instance, nor delete the IAM user that is associated with the instance. +The following ``uninstall`` example uninstalls the AWS CodeDeploy Agent from the on-premises instance and removes the on-premises configuration file from the instance. It doesn't deregister the instance in AWS CodeDeploy, nor disassociate any on-premises instance tags in AWS CodeDeploy from the instance, nor delete the IAM user that is associated with the instance. :: -Command:: + aws deploy uninstall - aws deploy uninstall - -Output:: - - This command produces no output. \ No newline at end of file +This command produces no output. diff --git a/bin/awscli/examples/deploy/update-application.rst b/bin/awscli/examples/deploy/update-application.rst old mode 100644 new mode 100755 index e5398efe..72282426 --- a/bin/awscli/examples/deploy/update-application.rst +++ b/bin/awscli/examples/deploy/update-application.rst @@ -1,11 +1,9 @@ -**To change information about an application** +**To change details of an application** -This example changes the name of an application that is associated with the user's AWS account. +The following ``update-application`` example changes the name of an application that is associated with the user's AWS account. :: -Command:: + aws deploy update-application \ + --application-name WordPress_App \ + --new-application-name My_WordPress_App - aws deploy update-application --application-name WordPress_App --new-application-name My_WordPress_App - -Output:: - - None. \ No newline at end of file +This command produces no output. diff --git a/bin/awscli/examples/deploy/update-deployment-group.rst b/bin/awscli/examples/deploy/update-deployment-group.rst old mode 100644 new mode 100755 index 3d598887..5c0861f3 --- a/bin/awscli/examples/deploy/update-deployment-group.rst +++ b/bin/awscli/examples/deploy/update-deployment-group.rst @@ -1,11 +1,14 @@ **To change information about a deployment group** -This example changes the settings of a deployment group that is associated with the specified application. - -Command:: - - aws deploy update-deployment-group --application-name WordPress_App --auto-scaling-groups My_CodeDeployDemo_ASG --current-deployment-group-name WordPress_DG --deployment-config-name CodeDeployDefault.AllAtOnce --ec2-tag-filters Key=Name,Type=KEY_AND_VALUE,Value=My_CodeDeployDemo --new-deployment-group-name My_WordPress_DepGroup --service-role-arn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemo-2 - -Output:: - - None. \ No newline at end of file +The following ``update-deployment-group`` example changes the settings of a deployment group that is associated with the specified application. :: + + aws deploy update-deployment-group \ + --application-name WordPress_App \ + --auto-scaling-groups My_CodeDeployDemo_ASG \ + --current-deployment-group-name WordPress_DG \ + --deployment-config-name CodeDeployDefault.AllAtOnce \ + --ec2-tag-filters Key=Name,Type=KEY_AND_VALUE,Value=My_CodeDeployDemo \ + --new-deployment-group-name My_WordPress_DepGroup \ + --service-role-arn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemo-2 + +This command produces no output. diff --git a/bin/awscli/examples/deploy/wait/deployment-successful.rst b/bin/awscli/examples/deploy/wait/deployment-successful.rst new file mode 100755 index 00000000..fe841a89 --- /dev/null +++ b/bin/awscli/examples/deploy/wait/deployment-successful.rst @@ -0,0 +1,7 @@ +**To pause script operations until a deployment is flagged as successful** + +The following ``wait deployment-successful`` example pauses until the specified deployment completes successfully. :: + + aws deploy wait deployment-successful --deployment-id d-A1B2C3111 + +This command produces no output, but pauses operation until the condition is met. It generates an error if the condition is not met after 120 checks that are 15 seconds apart. diff --git a/bin/awscli/examples/directconnect/allocate-hosted-connection.rst b/bin/awscli/examples/directconnect/allocate-hosted-connection.rst index 39dbf355..4c3c4377 100644 --- a/bin/awscli/examples/directconnect/allocate-hosted-connection.rst +++ b/bin/awscli/examples/directconnect/allocate-hosted-connection.rst @@ -1,21 +1,24 @@ -**To create a hosted connection on an interconnect** - -The following example creates a hosted connection on the specified interconnect. - -Command:: - - aws directconnect allocate-hosted-conection --bandwidth 500Mbps --connection-name mydcinterconnect --owner-account 123456789012 --connection-id dxcon-fgktov66 --vlan 101 - -Output:: - - { - "partnerName": "TIVIT", - "vlan": 101, - "ownerAccount": "123456789012", - "connectionId": "dxcon-ffzc51m1", - "connectionState": "ordering", - "bandwidth": "500Mbps", - "location": "TIVIT", - "connectionName": "mydcinterconnect", - "region": "sa-east-1" - } \ No newline at end of file +**To create a hosted connection on an interconnect** + +The following ``allocate-hosted-connection`` example creates a hosted connection on the specified interconnect. :: + + aws directconnect allocate-hosted-connection \ + --bandwidth 500Mbps \ + --connection-name mydcinterconnect \ + --owner-account 123456789012 + -connection-id dxcon-fgktov66 + -vlan 101 + +Output:: + + { + "partnerName": "TIVIT", + "vlan": 101, + "ownerAccount": "123456789012", + "connectionId": "dxcon-ffzc51m1", + "connectionState": "ordering", + "bandwidth": "500Mbps", + "location": "TIVIT", + "connectionName": "mydcinterconnect", + "region": "sa-east-1" + } diff --git a/bin/awscli/examples/directconnect/delete-direct-connect-gateway-association.rst b/bin/awscli/examples/directconnect/delete-direct-connect-gateway-association.rst index 003717bc..081b60af 100644 --- a/bin/awscli/examples/directconnect/delete-direct-connect-gateway-association.rst +++ b/bin/awscli/examples/directconnect/delete-direct-connect-gateway-association.rst @@ -1,19 +1,29 @@ -**To delete a Direct Connect gateway association** - -The following example disassociates virtual private gateway ``vgw-6efe725e`` from Direct Connect gateway ``5f294f92-bafb-4011-916d-9b0bexample``. - -Command:: - - aws directconnect delete-direct-connect-gateway-association --direct-connect-gateway-id 5f294f92-bafb-4011-916d-9b0bexample --virtual-gateway-id vgw-6efe725e - -Output:: - - { - "directConnectGatewayAssociation": { - "associationState": "disassociating", - "virtualGatewayOwnerAccount": "123456789012", - "directConnectGatewayId": "5f294f92-bafb-4011-916d-9b0bexample", - "virtualGatewayId": "vgw-6efe725e", - "virtualGatewayRegion": "us-east-2" - } - } \ No newline at end of file +**To delete a Direct Connect gateway association** + +The following ``delete-direct-connect-gateway-association`` example deletes the Direct Connect gateway association with a transit gateway that has the specified association ID. :: + + aws directconnect delete-direct-connect-gateway-association --association-id be85116d-46eb-4b43-a27a-da0c2ad648de + +Output:: + + { + "directConnectGatewayAssociation": { + "directConnectGatewayId": "11460968-4ac1-4fd3-bdb2-00599EXAMPlE", + "directConnectGatewayOwnerAccount": "123456789012", + "associationState": "disassociating", + "associatedGateway": { + "id": "tgw-095b3b0b54EXAMPLE", + "type": "transitGateway", + "ownerAccount": "123456789012", + "region": "us-east-1" + }, + "associationId": " be85116d-46eb-4b43-a27a-da0c2ad648deEXAMPLE ", + "allowedPrefixesToDirectConnectGateway": [ + { + "cidr": "192.0.1.0/28" + } + ] + } + } + +For more information, see `Associating and Disassociating Transit Gateways `_ in the *AWS Direct Connect User Guide*. diff --git a/bin/awscli/examples/dlm/create-default-role.rst b/bin/awscli/examples/dlm/create-default-role.rst index 404b8f6c..b218c681 100644 --- a/bin/awscli/examples/dlm/create-default-role.rst +++ b/bin/awscli/examples/dlm/create-default-role.rst @@ -1,5 +1,54 @@ -**To create the required IAM role for Amazon DLM +**To create the required IAM role for Amazon DLM** -Amazon DLM creates the **AWSDataLifecycleManagerDefaultRole** role the first time that you create a lifecycle policy using the AWS Management Console. If you are not using the console, you can use the following command to create this role.:: +Amazon DLM creates the **AWSDataLifecycleManagerDefaultRole** role the first time that you create a lifecycle policy using the AWS Management Console. If you are not using the console, you can use the following command to create this role. :: - aws dlm create-default-role + aws dlm create-default-role + +Output:: + + { + "RolePolicy": { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "ec2:CreateSnapshot", + "ec2:CreateSnapshots", + "ec2:DeleteSnapshot", + "ec2:DescribeInstances", + "ec2:DescribeVolumes", + "ec2:DescribeSnapshots" + ], + "Resource": "*" + }, + { + "Effect": "Allow", + "Action": [ + "ec2:CreateTags" + ], + "Resource": "arn:aws:ec2:*::snapshot/*" + } + ] + }, + "Role": { + "Path": "/", + "RoleName": "AWSDataLifecycleManagerDefaultRole", + "RoleId": "AROA012345678901EXAMPLE", + "Arn": "arn:aws:iam::123456789012:role/AWSDataLifecycleManagerDefaultRole", + "CreateDate": "2019-05-29T17:47:18Z", + "AssumeRolePolicyDocument": { + "Version": "2012-10-17", + "Statement": [ + { + "Sid": "", + "Effect": "Allow", + "Principal": { + "Service": "dlm.amazonaws.com" + }, + "Action": "sts:AssumeRole" + } + ] + } + } + } diff --git a/bin/awscli/examples/ec2/create-launch-template.rst b/bin/awscli/examples/ec2/create-launch-template.rst index 2c6c225b..6c7d8d03 100644 --- a/bin/awscli/examples/ec2/create-launch-template.rst +++ b/bin/awscli/examples/ec2/create-launch-template.rst @@ -1,20 +1,49 @@ **To create a launch template** -This example creates a launch template that specifies the subnet in which to launch the instance (``subnet-7b16de0c``), assigns a public IP address and an IPv6 address to the instance, and creates a tag for the instance (``Name=webserver``). +This example creates a launch template that specifies the subnet in which to launch the instance (``subnet-7b16de0c``), assigns a public IP address and an IPv6 address to the instance, and creates a tag for the instance (``purpose=webserver``). :: -Command:: + aws ec2 create-launch-template --launch-template-name TemplateForWebServer --version-description WebVersion1 --launch-template-data '{"NetworkInterfaces":[{"AssociatePublicIpAddress":true,"DeviceIndex":0,"Ipv6AddressCount":1,"SubnetId":"subnet-7b16de0c"}],"ImageId":"ami-8c1be5f6","InstanceType":"t2.small","TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"purpose","Value":"webserver"}]}]}' - aws ec2 create-launch-template --launch-template-name TemplateForWebServer --version-description WebVersion1 --launch-template-data '{"NetworkInterfaces":[{"AssociatePublicIpAddress":true,"DeviceIndex":0,"Ipv6AddressCount":1,"SubnetId":"subnet-7b16de0c"}],"ImageId":"ami-8c1be5f6","InstanceType":"t2.small","TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"webserver"}]}]}' +Output:: + + { + "LaunchTemplate": { + "LatestVersionNumber": 1, + "LaunchTemplateId": "lt-01238c059e3466abc", + "LaunchTemplateName": "TemplateForWebServer", + "DefaultVersionNumber": 1, + "CreatedBy": "arn:aws:iam::123456789012:user/Bob", + "CreateTime": "2019-01-27T09:13:24.000Z" + } + } + +For more information, see `Launching an Instance from a Launch Template`_ in the *Amazon Elastic Compute Cloud User Guide*. + +**To create a launch template for Amazon EC2 Auto Scaling** + +This example creates a launch template named TemplateForAutoScaling with multiple tags and a block device mapping to specify an additional EBS volume when an instance launches. Specify a value for ``Groups`` that corresponds to security groups for the VPC that your Auto Scaling group will launch instances into. Specify the VPC and subnets as properties of the Auto Scaling group. :: + + aws ec2 create-launch-template --launch-template-name TemplateForAutoScaling --version-description AutoScalingVersion1 --launch-template-data '{"NetworkInterfaces":[{"DeviceIndex":0,"AssociatePublicIpAddress":true,"Groups":["sg-7c227019,sg-903004f8"],"DeleteOnTermination":true}],"ImageId":"ami-b42209de","InstanceType":"m4.large","TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"environment","Value":"production"},{"Key":"purpose","Value":"webserver"}]},{"ResourceType":"volume","Tags":[{"Key":"environment","Value":"production"},{"Key":"cost-center","Value":"cc123"}]}],"BlockDeviceMappings":[{"DeviceName":"/dev/sda1","Ebs":{"VolumeSize":100}}]}' --region us-east-1 Output:: { - "LaunchTemplate": { - "LatestVersionNumber": 1, - "LaunchTemplateId": "lt-01238c059e3466abc", - "LaunchTemplateName": "TemplateForWebServer", - "DefaultVersionNumber": 1, - "CreatedBy": "arn:aws:iam::123456789012:root", - "CreateTime": "2017-11-27T09:13:24.000Z" - } - } \ No newline at end of file + "LaunchTemplate": { + "LatestVersionNumber": 1, + "LaunchTemplateId": "lt-0123c79c33a54e0abc", + "LaunchTemplateName": "TemplateForAutoScaling", + "DefaultVersionNumber": 1, + "CreatedBy": "arn:aws:iam::123456789012:user/Bob", + "CreateTime": "2019-04-30T18:16:06.000Z" + } + } + +For more information, see `Creating a Launch Template for an Auto Scaling Group`_ in the *Amazon EC2 Auto Scaling User Guide*. + +For information about quoting JSON-formatted parameters, see `Quoting Strings`_ in the *AWS Command Line Interface User Guide*. + +.. _`Launching an Instance from a Launch Template`: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html + +.. _`Creating a Launch Template for an Auto Scaling Group`: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html + +.. _`Quoting Strings`: https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html#quoting-strings diff --git a/bin/awscli/examples/ec2/create-placement-group.rst b/bin/awscli/examples/ec2/create-placement-group.rst index 446868ae..db163254 100644 --- a/bin/awscli/examples/ec2/create-placement-group.rst +++ b/bin/awscli/examples/ec2/create-placement-group.rst @@ -5,3 +5,11 @@ This example command creates a placement group with the specified name. Command:: aws ec2 create-placement-group --group-name my-cluster --strategy cluster + +**To create a partition placement group** + +This example command creates a partition placement group named ``HDFS-Group-A`` with five partitions. + +Command:: + + aws ec2 create-placement-group --group-name HDFS-Group-A --strategy partition --partition-count 5 diff --git a/bin/awscli/examples/ec2/describe-availability-zones.rst b/bin/awscli/examples/ec2/describe-availability-zones.rst index b765a2a7..f9965f59 100644 --- a/bin/awscli/examples/ec2/describe-availability-zones.rst +++ b/bin/awscli/examples/ec2/describe-availability-zones.rst @@ -12,21 +12,24 @@ Output:: "AvailabilityZones": [ { "State": "available", - "RegionName": "us-east-1", "Messages": [], - "ZoneName": "us-east-1b" + "RegionName": "us-west-2", + "ZoneName": "us-west-2a", + "ZoneId": "usw2-az2" }, { "State": "available", - "RegionName": "us-east-1", "Messages": [], - "ZoneName": "us-east-1c" + "RegionName": "us-west-2", + "ZoneName": "us-west-2b", + "ZoneId": "usw2-az1" }, { "State": "available", - "RegionName": "us-east-1", "Messages": [], - "ZoneName": "us-east-1d" + "RegionName": "us-west-2", + "ZoneName": "us-west-2c", + "ZoneId": "usw2-az3" } ] } diff --git a/bin/awscli/examples/ec2/describe-tags.rst b/bin/awscli/examples/ec2/describe-tags.rst index f5927fa6..8889f683 100644 --- a/bin/awscli/examples/ec2/describe-tags.rst +++ b/bin/awscli/examples/ec2/describe-tags.rst @@ -1,152 +1,149 @@ -**To describe your tags** +**Example 1: To describe your tags** -This example describes the tags for all your resources. +The following ``describe-tags`` example describes the tags for all your resources. :: -Command:: - - aws ec2 describe-tags + aws ec2 describe-tags Output:: - { - "Tags": [ - { - "ResourceType": "image", - "ResourceId": "ami-78a54011", - "Value": "Production", - "Key": "Stack" - }, - { - "ResourceType": "image", - "ResourceId": "ami-3ac33653", - "Value": "Test", - "Key": "Stack" - }, - { - "ResourceType": "instance", - "ResourceId": "i-1234567890abcdef0", - "Value": "Production", - "Key": "Stack" - }, - { - "ResourceType": "instance", - "ResourceId": "i-1234567890abcdef1", - "Value": "Test", - "Key": "Stack" - }, - { - "ResourceType": "instance", - "ResourceId": "i-1234567890abcdef5", - "Value": "Beta Server", - "Key": "Name" - }, - { - "ResourceType": "volume", - "ResourceId": "vol-049df61146c4d7901", - "Value": "Project1", - "Key": "Purpose" - }, - { - "ResourceType": "volume", - "ResourceId": "vol-1234567890abcdef0", - "Value": "Logs", - "Key": "Purpose" - } - ] - } - -**To describe the tags for a single resource** - -This example describes the tags for the specified instance. - -Command:: - - aws ec2 describe-tags --filters "Name=resource-id,Values=i-1234567890abcdef8" + { + "Tags": [ + { + "ResourceType": "image", + "ResourceId": "ami-78a54011", + "Value": "Production", + "Key": "Stack" + }, + { + "ResourceType": "image", + "ResourceId": "ami-3ac33653", + "Value": "Test", + "Key": "Stack" + }, + { + "ResourceType": "instance", + "ResourceId": "i-1234567890abcdef0", + "Value": "Production", + "Key": "Stack" + }, + { + "ResourceType": "instance", + "ResourceId": "i-1234567890abcdef1", + "Value": "Test", + "Key": "Stack" + }, + { + "ResourceType": "instance", + "ResourceId": "i-1234567890abcdef5", + "Value": "Beta Server", + "Key": "Name" + }, + { + "ResourceType": "volume", + "ResourceId": "vol-049df61146c4d7901", + "Value": "Project1", + "Key": "Purpose" + }, + { + "ResourceType": "volume", + "ResourceId": "vol-1234567890abcdef0", + "Value": "Logs", + "Key": "Purpose" + } + ] + } + +**Example 2: To describe the tags for a single resource** + +The following ``describe-tags`` example describes the tags for the specified instance. :: + + aws ec2 describe-tags \ + --filters "Name=resource-id,Values=i-1234567890abcdef8" Output:: - { - "Tags": [ - { - "ResourceType": "instance", - "ResourceId": "i-1234567890abcdef8", - "Value": "Test", - "Key": "Stack" - }, - { - "ResourceType": "instance", - "ResourceId": "i-1234567890abcdef8", - "Value": "Beta Server", - "Key": "Name" - } - ] - } + { + "Tags": [ + { + "ResourceType": "instance", + "ResourceId": "i-1234567890abcdef8", + "Value": "Test", + "Key": "Stack" + }, + { + "ResourceType": "instance", + "ResourceId": "i-1234567890abcdef8", + "Value": "Beta Server", + "Key": "Name" + } + ] + } + +**Example 3: To describe the tags for a type of resource** + +The following ``describe-tags`` example describes the tags for your volumes. :: + + aws ec2 describe-tags \ + --filters "Name=resource-type,Values=volume" + +Output:: -**To describe the tags for a type of resource** + { + "Tags": [ + { + "ResourceType": "volume", + "ResourceId": "vol-1234567890abcdef0", + "Value": "Project1", + "Key": "Purpose" + }, + { + "ResourceType": "volume", + "ResourceId": "vol-049df61146c4d7901", + "Value": "Logs", + "Key": "Purpose" + } + ] + } -This example describes the tags for your volumes. +**Example 4: To describe the tags for your resources based on a key and a value** -Command:: +The following ``describe-tags`` example describes the tags for your resources that have the key ``Stack`` and a value ``Test``. :: - aws ec2 describe-tags --filters "Name=resource-type,Values=volume" + aws ec2 describe-tags \ + --filters "Name=key,Values=Stack" "Name=value,Values=Test" Output:: - { - "Tags": [ - { - "ResourceType": "volume", - "ResourceId": "vol-1234567890abcdef0", - "Value": "Project1", - "Key": "Purpose" - }, - { - "ResourceType": "volume", - "ResourceId": "vol-049df61146c4d7901", - "Value": "Logs", - "Key": "Purpose" - } - ] - } + { + "Tags": [ + { + "ResourceType": "image", + "ResourceId": "ami-3ac33653", + "Value": "Test", + "Key": "Stack" + }, + { + "ResourceType": "instance", + "ResourceId": "i-1234567890abcdef8", + "Value": "Test", + "Key": "Stack" + } + ] + } + +**Example 5: To describe the tags for your resources based on a key and a value using the shortcut syntax** -**To describe the tags for your resources based on a key and a value** +The following ``describe-tags`` example is an alternative syntax to describe resources with the key ``Stack`` and a value ``Test``. :: -This example describes the tags for your resources that have the key ``Stack`` and a value ``Test``. + aws ec2 describe-tags --filters "Name=tag:Stack,Values=Test" -Command:: +**Example 6: To describe the tags for your resources based on only a key** - aws ec2 describe-tags --filters "Name=key,Values=Stack" "Name=value,Values=Test" +This example describes the tags for all your instances that have a tag with the key ``Purpose`` and no value. :: -Output:: + aws ec2 describe-tags \ + --filters "Name=resource-type,Values=instance" "Name=key,Values=Purpose" "Name=value,Values=" - { - "Tags": [ - { - "ResourceType": "image", - "ResourceId": "ami-3ac33653", - "Value": "Test", - "Key": "Stack" - }, - { - "ResourceType": "instance", - "ResourceId": "i-1234567890abcdef8", - "Value": "Test", - "Key": "Stack" - } - ] - } - -The following is an alternative syntax to describe resources with the key ``Stack`` and a value ``Test``. - -Command:: - aws ec2 describe-tags --filters "Name=tag:Stack,Values=Test" - -This example describes the tags for all your instances that have a tag with the key ``Purpose`` and no value. - -Command:: - - aws ec2 describe-tags --filters "Name=resource-type,Values=instance" "Name=key,Values=Purpose" "Name=value,Values=" - Output:: { diff --git a/bin/awscli/examples/ec2/modify-instance-event-start-time.rst b/bin/awscli/examples/ec2/modify-instance-event-start-time.rst new file mode 100644 index 00000000..ca49562b --- /dev/null +++ b/bin/awscli/examples/ec2/modify-instance-event-start-time.rst @@ -0,0 +1,20 @@ +**To modify the event start time for an instance** + +The following ``modify-instance-event-start-time`` command shows how to modify the event start time for the specified instance. Specify the event ID by using the ``--instance-event-id`` parameter. Specify the new date and time by using the ``--not-before`` parameter. :: + + aws ec2 modify-instance-event-start-time --instance-id i-1234567890abcdef0 --instance-event-id instance-event-0abcdef1234567890 --not-before 2019-03-25T10:00:00.000 + +Output:: + + "Event": { + "InstanceEventId": "instance-event-0abcdef1234567890", + "Code": "system-reboot", + "Description": "scheduled reboot", + "NotAfter": "2019-03-25T12:00:00.000Z", + "NotBefore": "2019-03-25T10:00:00.000Z", + "NotBeforeDeadline": "2019-04-22T21:00:00.000Z" + } + +For more information, see `Working with Instances Scheduled for Reboot`_ in the *Amazon Elastic Compute Cloud User Guide* + +.. _`Working with Instances Scheduled for Reboot`: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-instances-status-check_sched.html#schedevents_actions_reboot diff --git a/bin/awscli/examples/ec2/modify-volume.rst b/bin/awscli/examples/ec2/modify-volume.rst new file mode 100644 index 00000000..9a993b4e --- /dev/null +++ b/bin/awscli/examples/ec2/modify-volume.rst @@ -0,0 +1,53 @@ +**Example 1: To modify a volume by changing its size** + +The following ``modify-volume`` example modifies a volume by changing the volume's size to 150GB. :: + + aws ec2 modify-volume \ + --size 150 \ + --volume-id vol-1234567890abcdef0 + +Output:: + + { + "VolumeModification": { + "TargetSize": 150, + "TargetVolumeType": "io1", + "ModificationState": "modifying", + "VolumeId": " vol-1234567890abcdef0", + "TargetIops": 100, + "StartTime": "2019-05-17T11:27:19.000Z", + "Progress": 0, + "OriginalVolumeType": "io1", + "OriginalIops": 100, + "OriginalSize": 100 + } + } + +**Example 2: To modify a volume by changing its type, size, and IOPS value** + +The following ``modify-volume`` example changes the volume's `type` to a Provisioned IOPS SSD (`io1`), sets the target IOPS rate to 10000, and sets the volume size to `350GB`. :: + + aws ec2 modify-volume \ + --volume-type io1 \ + --iops 10000 \ + --size 350 \ + --volume-id vol-1234567890abcdef0 + +Output:: + + { + "VolumeModification": { + "TargetSize": 350, + "TargetVolumeType": "io1", + "ModificationState": "modifying", + "VolumeId": "vol-0721c1a9d08c93bf6", + "TargetIops": 10000, + "StartTime": "2019-05-17T11:38:57.000Z", + "Progress": 0, + "OriginalVolumeType": "gp2", + "OriginalIops": 150, + "OriginalSize": 50 + } + } + +For more information, see `Modifying the Size, Performance, or Type of an EBS Volume `_ in the *Amazon Elastic Compute Cloud User Guide for Linux Instances*. diff --git a/bin/awscli/examples/ec2/run-instances.rst b/bin/awscli/examples/ec2/run-instances.rst index 7934f1d9..af47070c 100644 --- a/bin/awscli/examples/ec2/run-instances.rst +++ b/bin/awscli/examples/ec2/run-instances.rst @@ -301,26 +301,26 @@ Command:: aws ec2 run-instances --image-id ami-abc12345 --count 1 --instance-type t2.micro --key-name MyKeyPair --subnet-id subnet-6e7f829e --tag-specifications 'ResourceType=instance,Tags=[{Key=webserver,Value=production}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]' -**To launch an instance with the credit option for CPU usage of "unlimited"** +**To launch an instance with the credit option for CPU usage of ``unlimited``** -You can launch an instance and specify the credit option for CPU usage for the instance. If you do not specify the credit option, the instance launches with the default "standard" credit option. The following example launches a t2.micro instance with the "unlimited" credit option. +You can launch a burstable performance instance (T2 and T3) and specify the credit option for CPU usage for the instance. If you do not specify the credit option, a T2 instance launches with the default ``standard`` credit option and a T3 instance launches with the default ``unlimited`` credit option. The following example launches a t2.micro instance with the ``unlimited`` credit option. Command:: aws ec2 run-instances --image-id ami-abc12345 --count 1 --instance-type t2.micro --key-name MyKeyPair --credit-specification CpuCredits=unlimited -**To launch an instance with a custom number of vCPUs** - -This example launches an ``r4.4xlarge`` instance type with six vCPUs (three CPU cores multiplied by two threads per core). - +**To launch an instance into a partition placement group** + +You can launch an instance into a partition placement group without specifying the partition. In this example, the partition placement group is named ``HDFS-Group-A``. + Command:: - - aws ec2 run-instances --image-id ami-1a2b3c4d --instance-type r4.4xlarge --cpu-options "CoreCount=3,ThreadsPerCore=2" --key-name MyKeyPair - -**To launch an instance and disable hyperthreading** - -This example launchs an ``r4.4xlarge`` instance type and disables hyperthreading by specifying one thread per core and specifying the default number of CPU cores for the instance type (eight). - + + aws ec2 run-instances --placement "GroupName = HDFS-Group-A" + +**To launch an instance into a specific partition of a partition placement group** + +You can launch an instance into a specific partition of a partition placement group by specifying the partition number. In this example, the partition placement group is named ``HDFS-Group-A`` and the partition number is ``3``. + Command:: - - aws ec2 run-instances --image-id ami-1a2b3c4d --instance-type r4.4xlarge --cpu-options "CoreCount=8,ThreadsPerCore=1" --key-name MyKeyPair \ No newline at end of file + + aws ec2 run-instances --placement "GroupName = HDFS-Group-A, PartitionNumber = 3" diff --git a/bin/awscli/examples/ecs/create-cluster.rst b/bin/awscli/examples/ecs/create-cluster.rst index 6d3797c0..5ec5f222 100644 --- a/bin/awscli/examples/ecs/create-cluster.rst +++ b/bin/awscli/examples/ecs/create-cluster.rst @@ -1,21 +1,60 @@ -**To create a new cluster** +**Example 1: To create a new cluster** -This example command creates a cluster in your default region. +The following ``create-cluster`` example creates a cluster. :: -Command:: + aws ecs create-cluster --cluster-name MyCluster - aws ecs create-cluster --cluster-name "my_cluster" +Output:: + + { + "cluster": { + "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", + "clusterName": "MyCluster", + "status": "ACTIVE", + "registeredContainerInstancesCount": 0, + "pendingTasksCount": 0, + "runningTasksCount": 0, + "activeServicesCount": 0, + "statistics": [], + "tags": [] + } + } + +**Example 2: To create a new cluster with multiple tags** + +The following ``create-cluster`` example creates a cluster with multiple tags. For more information about adding tags using shorthand syntax, see `Using Shorthand Syntax with the AWS Command Line Interface `_ in the *AWS CLI User Guide*. :: + + aws ecs create-cluster \ + --cluster-name MyCluster \ + --tags key=key1,value=value1 key=key2,value=value2 key=key3,value=value3 Output:: - { - "cluster": { - "status": "ACTIVE", - "clusterName": "my_cluster", - "registeredContainerInstancesCount": 0, - "pendingTasksCount": 0, - "runningTasksCount": 0, - "activeServicesCount": 0, - "clusterArn": "arn:aws:ecs:::cluster/my_cluster" - } - } + { + "cluster": { + "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", + "clusterName": "MyCluster", + "status": "ACTIVE", + "registeredContainerInstancesCount": 0, + "pendingTasksCount": 0, + "runningTasksCount": 0, + "activeServicesCount": 0, + "statistics": [], + "tags": [ + { + "key": "key1", + "value": "value1" + }, + { + "key": "key2", + "value": "value2" + }, + { + "key": "key3", + "value": "value3" + } + ] + } + } + +For more information, see `Creating a Cluster `_ in the *Amazon ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/create-service.rst b/bin/awscli/examples/ecs/create-service.rst index f611a131..b6c1997d 100644 --- a/bin/awscli/examples/ecs/create-service.rst +++ b/bin/awscli/examples/ecs/create-service.rst @@ -1,55 +1,204 @@ -**To create a new service** +**Example 1: To create a service with a Fargate task** -This example command creates a service in your default region called ``ecs-simple-service``. The service uses the ``ecs-demo`` task definition and it maintains 10 instantiations of that task. +The following ``create-service`` example shows how to create a service using a Fargate task. :: -Command:: + aws ecs create-service \ + --cluster MyCluster \ + --service-name MyService \ + --task-definition sample-fargate:1 \ + --desired-count 2 \ + --launch-type FARGATE \ + --platform-version LATEST \ + --network-configuration "awsvpcConfiguration={subnets=[subnet-12344321],securityGroups=[sg-12344321],assignPublicIp=ENABLED}" \ + --tags key=key1,value=value1 key=key2,value=value2 key=key3,value=value3 + +Output:: + + { + "service": { + "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/MyCluster/MyService", + "serviceName": "MyService", + "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", + "loadBalancers": [], + "serviceRegistries": [], + "status": "ACTIVE", + "desiredCount": 2, + "runningCount": 0, + "pendingCount": 0, + "launchType": "FARGATE", + "platformVersion": "LATEST", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:1", + "deploymentConfiguration": { + "maximumPercent": 200, + "minimumHealthyPercent": 100 + }, + "deployments": [ + { + "id": "ecs-svc/1234567890123456789", + "status": "PRIMARY", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:1", + "desiredCount": 2, + "pendingCount": 0, + "runningCount": 0, + "createdAt": 1557119253.821, + "updatedAt": 1557119253.821, + "launchType": "FARGATE", + "platformVersion": "1.3.0", + "networkConfiguration": { + "awsvpcConfiguration": { + "subnets": [ + "subnet-12344321" + ], + "securityGroups": [ + "sg-12344321" + ], + "assignPublicIp": "ENABLED" + } + } + } + ], + "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS", + "events": [], + "createdAt": 1557119253.821, + "placementConstraints": [], + "placementStrategy": [], + "networkConfiguration": { + "awsvpcConfiguration": { + "subnets": [ + "subnet-12344321" + ], + "securityGroups": [ + "sg-12344321" + ], + "assignPublicIp": "ENABLED" + } + }, + "schedulingStrategy": "REPLICA", + "tags": [ + { + "key": "key1", + "value": "value1" + }, + { + "key": "key2", + "value": "value2" + }, + { + "key": "key3", + "value": "value3" + } + ], + "enableECSManagedTags": false, + "propagateTags": "NONE" + } + } - aws ecs create-service --service-name ecs-simple-service --task-definition ecs-demo --desired-count 10 +**Example 2: To create a service using the EC2 launch type** + +The following ``create-service`` example shows how to create a service called ``ecs-simple-service`` with a task that uses the EC2 launch type. The service uses the ``sleep360`` task definition and it maintains 1 instantiation of the task. :: + + aws ecs create-service \ + --cluster MyCluster \ + --service-name ecs-simple-service \ + --task-definition sleep360:2 \ + --desired-count 1 Output:: - { - "service": { - "status": "ACTIVE", - "taskDefinition": "arn:aws:ecs:::task-definition/ecs-demo:1", - "pendingCount": 0, - "loadBalancers": [], - "desiredCount": 10, - "serviceName": "ecs-simple-service", - "clusterArn": "arn:aws:ecs:::cluster/default", - "serviceArn": "arn:aws:ecs:::service/ecs-simple-service", - "deployments": [ - { - "status": "PRIMARY", - "pendingCount": 0, - "createdAt": 1428096748.604, - "desiredCount": 10, - "taskDefinition": "arn:aws:ecs:::task-definition/ecs-demo:1", - "updatedAt": 1428096748.604, - "id": "ecs-svc/", - "runningCount": 0 - } - ], - "events": [], - "runningCount": 0 - } - } - - -**To create a new service behind a load balancer** - -This example command creates a service in your default region called ``ecs-simple-service-elb``. The service uses the ``ecs-demo`` task definition and it maintains 10 instantiations of that task. You must have a load balancer configured in the same region as your container instances. - -This example uses the ``--cli-input-json`` option and a JSON input file called ``ecs-simple-service-elb.json`` with the below format. - -Input file:: + { + "service": { + "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/MyCluster/ecs-simple-service", + "serviceName": "ecs-simple-service", + "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", + "loadBalancers": [], + "serviceRegistries": [], + "status": "ACTIVE", + "desiredCount": 1, + "runningCount": 0, + "pendingCount": 0, + "launchType": "EC2", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep360:2", + "deploymentConfiguration": { + "maximumPercent": 200, + "minimumHealthyPercent": 100 + }, + "deployments": [ + { + "id": "ecs-svc/1234567890123456789", + "status": "PRIMARY", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep360:2", + "desiredCount": 1, + "pendingCount": 0, + "runningCount": 0, + "createdAt": 1557206498.798, + "updatedAt": 1557206498.798, + "launchType": "EC2" + } + ], + "events": [], + "createdAt": 1557206498.798, + "placementConstraints": [], + "placementStrategy": [], + "schedulingStrategy": "REPLICA", + "enableECSManagedTags": false, + "propagateTags": "NONE" + } + } + +**Example 3: To create a service that uses an external deployment controller** + +The following ``create-service`` example creates a service that uses an external deployment controller. :: + + aws ecs create-service \ + --cluster MyCluster \ + --service-name MyService \ + --deployment-controller type=EXTERNAL \ + --desired-count 1 + +Output:: + + { + "service": { + "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/MyCluster/MyService", + "serviceName": "MyService", + "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", + "loadBalancers": [], + "serviceRegistries": [], + "status": "ACTIVE", + "desiredCount": 1, + "runningCount": 0, + "pendingCount": 0, + "launchType": "EC2", + "deploymentConfiguration": { + "maximumPercent": 200, + "minimumHealthyPercent": 100 + }, + "taskSets": [], + "deployments": [], + "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS", + "events": [], + "createdAt": 1557128207.101, + "placementConstraints": [], + "placementStrategy": [], + "schedulingStrategy": "REPLICA", + "deploymentController": { + "type": "EXTERNAL" + }, + "enableECSManagedTags": false, + "propagateTags": "NONE" + } + } + +**Example 4: To create a new service behind a load balancer** + +The following ``create-service`` example shows how to create a service that is behind a load balancer. You must have a load balancer configured in the same Region as your container instance. This example uses the ``--cli-input-json`` option and a JSON input file called ``ecs-simple-service-elb.json`` with the following content:: { "serviceName": "ecs-simple-service-elb", "taskDefinition": "ecs-demo", "loadBalancers": [ { - "loadBalancerName": "EC2Contai-EcsElast-S06278JGSJCM", + "loadBalancerName": "EC2Contai-EcsElast-123456789012", "containerName": "simple-demo", "containerPort": 80 } @@ -60,40 +209,45 @@ Input file:: Command:: - aws ecs create-service --service-name ecs-simple-service-elb --cli-input-json file://ecs-simple-service-elb.json + aws ecs create-service \ + --cluster MyCluster \ + --service-name ecs-simple-service-elb \ + --cli-input-json file://ecs-simple-service-elb.json Output:: - { - "service": { - "status": "ACTIVE", - "taskDefinition": "arn:aws:ecs:::task-definition/ecs-demo:1", - "pendingCount": 0, - "loadBalancers": [ - { - "containerName": "ecs-demo", - "containerPort": 80, - "loadBalancerName": "EC2Contai-EcsElast-S06278JGSJCM" - } - ], - "roleArn": "arn:aws:iam:::role/ecsServiceRole", - "desiredCount": 10, - "serviceName": "ecs-simple-service-elb", - "clusterArn": "arn:aws:ecs:::cluster/default", - "serviceArn": "arn:aws:ecs:::service/ecs-simple-service-elb", - "deployments": [ - { - "status": "PRIMARY", - "pendingCount": 0, - "createdAt": 1428100239.123, - "desiredCount": 10, - "taskDefinition": "arn:aws:ecs:::task-definition/ecs-demo:1", - "updatedAt": 1428100239.123, - "id": "ecs-svc/", - "runningCount": 0 - } - ], - "events": [], - "runningCount": 0 - } - } \ No newline at end of file + { + "service": { + "status": "ACTIVE", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/ecs-demo:1", + "pendingCount": 0, + "loadBalancers": [ + { + "containerName": "ecs-demo", + "containerPort": 80, + "loadBalancerName": "EC2Contai-EcsElast-123456789012" + } + ], + "roleArn": "arn:aws:iam::123456789012:role/ecsServiceRole", + "desiredCount": 10, + "serviceName": "ecs-simple-service-elb", + "clusterArn": "arn:aws:ecs:`_ in the *Amazon ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/create-task-set.rst b/bin/awscli/examples/ecs/create-task-set.rst new file mode 100644 index 00000000..3fca4ffa --- /dev/null +++ b/bin/awscli/examples/ecs/create-task-set.rst @@ -0,0 +1,45 @@ +**To create a task set** + +The following ``create-task-set`` example creates a task set in a service that uses an external deployment controller. :: + + aws ecs create-task-set \ + --cluster MyCluster \ + --service MyService \ + --task-definition MyTaskDefinition:2 \ + --network-configuration "awsvpcConfiguration={subnets=[subnet-12344321],securityGroups=[sg-12344321]}" + +Output:: + + { + "taskSet": { + "id": "ecs-svc/1234567890123456789", + "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", + "status": "ACTIVE", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/MyTaskDefinition:2", + "computedDesiredCount": 0, + "pendingCount": 0, + "runningCount": 0, + "createdAt": 1557128360.711, + "updatedAt": 1557128360.711, + "launchType": "EC2", + "networkConfiguration": { + "awsvpcConfiguration": { + "subnets": [ + "subnet-12344321" + ], + "securityGroups": [ + "sg-12344321" + ], + "assignPublicIp": "DISABLED" + } + }, + "loadBalancers": [], + "serviceRegistries": [], + "scale": { + "value": 0.0, + "unit": "PERCENT" + }, + "stabilityStatus": "STABILIZING", + "stabilityStatusAt": 1557128360.711 + } + } diff --git a/bin/awscli/examples/ecs/delete-account-setting.rst b/bin/awscli/examples/ecs/delete-account-setting.rst new file mode 100644 index 00000000..25ee0419 --- /dev/null +++ b/bin/awscli/examples/ecs/delete-account-setting.rst @@ -0,0 +1,19 @@ +**To delete the account settings for a specific IAM user or IAM role** + +The following example ``delete-account-setting`` deletes the account settings for the specific IAM user or IAM role. :: + + aws ecs delete-account-setting \ + --name serviceLongArnFormat \ + --principal-arn arn:aws:iam::123456789012:user/MyUser + +Output:: + + { + "setting": { + "name": "serviceLongArnFormat", + "value": "enabled", + "principalArn": "arn:aws:iam::123456789012:user/MyUser" + } + } + +For more information, see `Amazon Resource Names (ARNs) and IDs `_ in the *Amazon ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/delete-cluster.rst b/bin/awscli/examples/ecs/delete-cluster.rst index c9c9e382..78440214 100644 --- a/bin/awscli/examples/ecs/delete-cluster.rst +++ b/bin/awscli/examples/ecs/delete-cluster.rst @@ -1,21 +1,23 @@ **To delete an empty cluster** -This example command deletes an empty cluster in your default region. +The following ``delete-cluster`` example deletes the specified empty cluster. :: -Command:: - - aws ecs delete-cluster --cluster my_cluster + aws ecs delete-cluster --cluster MyCluster Output:: - { - "cluster": { - "status": "INACTIVE", - "clusterName": "my_cluster", - "registeredContainerInstancesCount": 0, - "pendingTasksCount": 0, - "runningTasksCount": 0, - "activeServicesCount": 0, - "clusterArn": "arn:aws:ecs:::cluster/my_cluster" - } - } + { + "cluster": { + "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", + "status": "INACTIVE", + "clusterName": "MyCluster", + "registeredContainerInstancesCount": 0, + "pendingTasksCount": 0, + "runningTasksCount": 0, + "activeServicesCount": 0 + "statistics": [], + "tags": [] + } + } + +For more information, see `Deleting a Cluster `_ in the *Amazon ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/delete-service.rst b/bin/awscli/examples/ecs/delete-service.rst index c4488908..0611aa59 100644 --- a/bin/awscli/examples/ecs/delete-service.rst +++ b/bin/awscli/examples/ecs/delete-service.rst @@ -1,8 +1,7 @@ **To delete a service** -This example command deletes the ``my-http-service`` service. The service must have a desired count and running count of 0 before you can delete it. +The following ``ecs delete-service`` example deletes the specified service from a cluster. You can include the ``--force`` parameter to delete a service even if it has not been scaled to zero tasks. :: -Command:: - - aws ecs delete-service --service my-http-service + aws ecs delete-service --cluster MyCluster --service MyService1 --force +For more information, see `Deleting a Service `_ in the *Amazon ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/delete-task-set.rst b/bin/awscli/examples/ecs/delete-task-set.rst new file mode 100644 index 00000000..66c65694 --- /dev/null +++ b/bin/awscli/examples/ecs/delete-task-set.rst @@ -0,0 +1,45 @@ +**To delete a task set** + +The following ``delete-task-set`` example shows how to delete a task set. You can include the ``--force`` parameter to delete a task set even if it has not been scaled to zero. :: + + aws ecs delete-task-set \ + --cluster MyCluster \ + --service MyService \ + --task-set arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789 \ + --force + +Output:: + + { + "taskSet": { + "id": "ecs-svc/1234567890123456789", + "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", + "status": "DRAINING", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", + "computedDesiredCount": 0, + "pendingCount": 0, + "runningCount": 0, + "createdAt": 1557130260.276, + "updatedAt": 1557130290.707, + "launchType": "EC2", + "networkConfiguration": { + "awsvpcConfiguration": { + "subnets": [ + "subnet-12345678" + ], + "securityGroups": [ + "sg-12345678" + ], + "assignPublicIp": "DISABLED" + } + }, + "loadBalancers": [], + "serviceRegistries": [], + "scale": { + "value": 0.0, + "unit": "PERCENT" + }, + "stabilityStatus": "STABILIZING", + "stabilityStatusAt": 1557130290.707 + } + } diff --git a/bin/awscli/examples/ecs/deregister-container-instance.rst b/bin/awscli/examples/ecs/deregister-container-instance.rst index 6359d019..32b52580 100644 --- a/bin/awscli/examples/ecs/deregister-container-instance.rst +++ b/bin/awscli/examples/ecs/deregister-container-instance.rst @@ -1,7 +1,262 @@ **To deregister a container instance from a cluster** -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. +The following ``deregister-container-instance`` example deregisters a container instance from the specified cluster. If there are still tasks running in the container instance, you must either stop those tasks before deregistering, or use the ``--force`` option. :: -Command:: + aws ecs deregister-container-instance \ + --cluster arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster \ + --container-instance arn:aws:ecs:us-west-2:123456789012:container-instance/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \ + --force - aws ecs deregister-container-instance --cluster default --container-instance --force \ No newline at end of file +Output:: + + { + "containerInstance": { + "remainingResources": [ + { + "integerValue": 1024, + "doubleValue": 0.0, + "type": "INTEGER", + "longValue": 0, + "name": "CPU" + }, + { + "integerValue": 985, + "doubleValue": 0.0, + "type": "INTEGER", + "longValue": 0, + "name": "MEMORY" + }, + { + "type": "STRINGSET", + "integerValue": 0, + "name": "PORTS", + "stringSetValue": [ + "22", + "2376", + "2375", + "51678", + "51679" + ], + "longValue": 0, + "doubleValue": 0.0 + }, + { + "type": "STRINGSET", + "integerValue": 0, + "name": "PORTS_UDP", + "stringSetValue": [], + "longValue": 0, + "doubleValue": 0.0 + } + ], + "agentConnected": true, + "attributes": [ + { + "name": "ecs.capability.secrets.asm.environment-variables" + }, + { + "name": "com.amazonaws.ecs.capability.logging-driver.syslog" + }, + { + "value": "ami-01a82c3fce2c3ba58", + "name": "ecs.ami-id" + }, + { + "name": "ecs.capability.secrets.asm.bootstrap.log-driver" + }, + { + "name": "com.amazonaws.ecs.capability.logging-driver.none" + }, + { + "name": "ecs.capability.ecr-endpoint" + }, + { + "name": "com.amazonaws.ecs.capability.logging-driver.json-file" + }, + { + "value": "vpc-1234567890123467", + "name": "ecs.vpc-id" + }, + { + "name": "ecs.capability.execution-role-awslogs" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.17" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.18" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.19" + }, + { + "name": "ecs.capability.docker-plugin.local" + }, + { + "name": "ecs.capability.task-eni" + }, + { + "name": "ecs.capability.task-cpu-mem-limit" + }, + { + "name": "ecs.capability.secrets.ssm.bootstrap.log-driver" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.30" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.31" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.32" + }, + { + "name": "ecs.capability.execution-role-ecr-pull" + }, + { + "name": "ecs.capability.container-health-check" + }, + { + "value": "subnet-1234567890123467", + "name": "ecs.subnet-id" + }, + { + "value": "us-west-2a", + "name": "ecs.availability-zone" + }, + { + "value": "t2.micro", + "name": "ecs.instance-type" + }, + { + "name": "com.amazonaws.ecs.capability.task-iam-role-network-host" + }, + { + "name": "ecs.capability.aws-appmesh" + }, + { + "name": "com.amazonaws.ecs.capability.logging-driver.awslogs" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.24" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.25" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.26" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.27" + }, + { + "name": "com.amazonaws.ecs.capability.privileged-container" + }, + { + "name": "ecs.capability.container-ordering" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.28" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.29" + }, + { + "value": "x86_64", + "name": "ecs.cpu-architecture" + }, + { + "value": "93f43776-2018.10.0", + "name": "ecs.capability.cni-plugin-version" + }, + { + "name": "ecs.capability.secrets.ssm.environment-variables" + }, + { + "name": "ecs.capability.pid-ipc-namespace-sharing" + }, + { + "name": "com.amazonaws.ecs.capability.ecr-auth" + }, + { + "value": "linux", + "name": "ecs.os-type" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.20" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.21" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.22" + }, + { + "name": "ecs.capability.task-eia" + }, + { + "name": "ecs.capability.private-registry-authentication.secretsmanager" + }, + { + "name": "com.amazonaws.ecs.capability.task-iam-role" + }, + { + "name": "com.amazonaws.ecs.capability.docker-remote-api.1.23" + } + ], + "pendingTasksCount": 0, + "tags": [], + "containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "registeredResources": [ + { + "integerValue": 1024, + "doubleValue": 0.0, + "type": "INTEGER", + "longValue": 0, + "name": "CPU" + }, + { + "integerValue": 985, + "doubleValue": 0.0, + "type": "INTEGER", + "longValue": 0, + "name": "MEMORY" + }, + { + "type": "STRINGSET", + "integerValue": 0, + "name": "PORTS", + "stringSetValue": [ + "22", + "2376", + "2375", + "51678", + "51679" + ], + "longValue": 0, + "doubleValue": 0.0 + }, + { + "type": "STRINGSET", + "integerValue": 0, + "name": "PORTS_UDP", + "stringSetValue": [], + "longValue": 0, + "doubleValue": 0.0 + } + ], + "status": "INACTIVE", + "registeredAt": 1557768075.681, + "version": 4, + "versionInfo": { + "agentVersion": "1.27.0", + "agentHash": "aabe65ee", + "dockerVersion": "DockerVersion: 18.06.1-ce" + }, + "attachments": [], + "runningTasksCount": 0, + "ec2InstanceId": "i-12345678901234678" + } + } + +For more information, see `Deregister a Container Instance `_ in the *ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/deregister-task-definition.rst b/bin/awscli/examples/ecs/deregister-task-definition.rst index 271a4d6e..6fd5d4b2 100644 --- a/bin/awscli/examples/ecs/deregister-task-definition.rst +++ b/bin/awscli/examples/ecs/deregister-task-definition.rst @@ -1,36 +1,36 @@ **To deregister a task definition** -This example deregisters the first revision of the ``curler`` task definition in your default region. Note that in the resulting output, the task definition status becomes ``INACTIVE``. - -Command:: +The following ``deregister-task-definition`` example deregisters the first revision of the ``curler`` task definition in your default region. :: aws ecs deregister-task-definition --task-definition curler:1 -Output:: +Note that in the resulting output, the task definition status shows ``INACTIVE``:: + + { + "taskDefinition": { + "status": "INACTIVE", + "family": "curler", + "volumes": [], + "taskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:task-definition/curler:1", + "containerDefinitions": [ + { + "environment": [], + "name": "curler", + "mountPoints": [], + "image": "curl:latest", + "cpu": 100, + "portMappings": [], + "entryPoint": [], + "memory": 256, + "command": [ + "curl -v http://example.com/" + ], + "essential": true, + "volumesFrom": [] + } + ], + "revision": 1 + } + } - { - "taskDefinition": { - "status": "INACTIVE", - "family": "curler", - "volumes": [], - "taskDefinitionArn": "arn:aws:ecs:us-west-2::task-definition/curler:1", - "containerDefinitions": [ - { - "environment": [], - "name": "curler", - "mountPoints": [], - "image": "curl:latest", - "cpu": 100, - "portMappings": [], - "entryPoint": [], - "memory": 256, - "command": [ - "curl -v http://example.com/" - ], - "essential": true, - "volumesFrom": [] - } - ], - "revision": 1 - } - } \ No newline at end of file +For more information, see `Amazon ECS Task Definitions `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/describe-clusters.rst b/bin/awscli/examples/ecs/describe-clusters.rst index a1174146..9d3034f5 100644 --- a/bin/awscli/examples/ecs/describe-clusters.rst +++ b/bin/awscli/examples/ecs/describe-clusters.rst @@ -1,24 +1,24 @@ **To describe a cluster** -This example command provides a description of the specified cluster in your default region. +The following ``describe-clusters`` example retrieves details about the specified cluster. :: -Command:: - - aws ecs describe-clusters --cluster default + aws ecs describe-clusters --cluster default Output:: - { - "clusters": [ - { - "status": "ACTIVE", - "clusterName": "default", - "registeredContainerInstancesCount": 0, - "pendingTasksCount": 0, - "runningTasksCount": 0, - "activeServicesCount": 1, - "clusterArn": "arn:aws:ecs:us-west-2::cluster/default" - } - ], - "failures": [] - } + { + "clusters": [ + { + "status": "ACTIVE", + "clusterName": "default", + "registeredContainerInstancesCount": 0, + "pendingTasksCount": 0, + "runningTasksCount": 0, + "activeServicesCount": 1, + "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/default" + } + ], + "failures": [] + } + +For more information, see `Amazon ECS Clusters `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/describe-container-instances.rst b/bin/awscli/examples/ecs/describe-container-instances.rst index afdce163..4b876eed 100644 --- a/bin/awscli/examples/ecs/describe-container-instances.rst +++ b/bin/awscli/examples/ecs/describe-container-instances.rst @@ -1,86 +1,88 @@ **To describe container instance** -This example command provides a description of the specified container instance in the ``update`` cluster, using the container instance UUID as an identifier. +The following ``describe-container-instances`` example retrieves details for a container instance in the ``update`` cluster, using the container instance UUID as an identifier. :: -Command:: - - aws ecs describe-container-instances --cluster update --container-instances 53ac7152-dcd1-4102-81f5-208962864132 + aws ecs describe-container-instances \ + --cluster update \ + --container-instances a1b2c3d4-5678-90ab-cdef-11111EXAMPLE Output:: - { - "failures": [], - "containerInstances": [ - { - "status": "ACTIVE", - "registeredResources": [ - { - "integerValue": 2048, - "longValue": 0, - "type": "INTEGER", - "name": "CPU", - "doubleValue": 0.0 - }, - { - "integerValue": 3955, - "longValue": 0, - "type": "INTEGER", - "name": "MEMORY", - "doubleValue": 0.0 - }, - { - "name": "PORTS", - "longValue": 0, - "doubleValue": 0.0, - "stringSetValue": [ - "22", - "2376", - "2375", - "51678" - ], - "type": "STRINGSET", - "integerValue": 0 - } - ], - "ec2InstanceId": "i-f3c1de3a", - "agentConnected": true, - "containerInstanceArn": "arn:aws:ecs:us-west-2::container-instance/53ac7152-dcd1-4102-81f5-208962864132", - "pendingTasksCount": 0, - "remainingResources": [ - { - "integerValue": 2048, - "longValue": 0, - "type": "INTEGER", - "name": "CPU", - "doubleValue": 0.0 - }, - { - "integerValue": 3955, - "longValue": 0, - "type": "INTEGER", - "name": "MEMORY", - "doubleValue": 0.0 - }, - { - "name": "PORTS", - "longValue": 0, - "doubleValue": 0.0, - "stringSetValue": [ - "22", - "2376", - "2375", - "51678" - ], - "type": "STRINGSET", - "integerValue": 0 - } - ], - "runningTasksCount": 0, - "versionInfo": { - "agentVersion": "1.0.0", - "agentHash": "4023248", - "dockerVersion": "DockerVersion: 1.5.0" - } - } - ] - } \ No newline at end of file + { + "failures": [], + "containerInstances": [ + { + "status": "ACTIVE", + "registeredResources": [ + { + "integerValue": 2048, + "longValue": 0, + "type": "INTEGER", + "name": "CPU", + "doubleValue": 0.0 + }, + { + "integerValue": 3955, + "longValue": 0, + "type": "INTEGER", + "name": "MEMORY", + "doubleValue": 0.0 + }, + { + "name": "PORTS", + "longValue": 0, + "doubleValue": 0.0, + "stringSetValue": [ + "22", + "2376", + "2375", + "51678" + ], + "type": "STRINGSET", + "integerValue": 0 + } + ], + "ec2InstanceId": "i-A1B2C3D4", + "agentConnected": true, + "containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "pendingTasksCount": 0, + "remainingResources": [ + { + "integerValue": 2048, + "longValue": 0, + "type": "INTEGER", + "name": "CPU", + "doubleValue": 0.0 + }, + { + "integerValue": 3955, + "longValue": 0, + "type": "INTEGER", + "name": "MEMORY", + "doubleValue": 0.0 + }, + { + "name": "PORTS", + "longValue": 0, + "doubleValue": 0.0, + "stringSetValue": [ + "22", + "2376", + "2375", + "51678" + ], + "type": "STRINGSET", + "integerValue": 0 + } + ], + "runningTasksCount": 0, + "versionInfo": { + "agentVersion": "1.0.0", + "agentHash": "4023248", + "dockerVersion": "DockerVersion: 1.5.0" + } + } + ] + } + +For more information, see `Amazon ECS Container Instances `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/describe-services.rst b/bin/awscli/examples/ecs/describe-services.rst index 01f22b88..b8d67ebc 100644 --- a/bin/awscli/examples/ecs/describe-services.rst +++ b/bin/awscli/examples/ecs/describe-services.rst @@ -1,46 +1,46 @@ **To describe a service** -This example command provides descriptive information about the ``my-http-service``. +The following ``describe-services`` example retrieves details for the ``my-http-service`` service in the default cluster. :: -Command:: - - aws ecs describe-services --service my-http-service + aws ecs describe-services --services my-http-service Output:: - { - "services": [ - { - "status": "ACTIVE", - "taskDefinition": "arn:aws:ecs:::task-definition/amazon-ecs-sample:1", - "pendingCount": 0, - "loadBalancers": [], - "desiredCount": 10, - "createdAt": 1466801808.595, - "serviceName": "my-http-service", - "clusterArn": "arn:aws:ecs:::cluster/default", - "serviceArn": "arn:aws:ecs:::service/my-http-service", - "deployments": [ - { - "status": "PRIMARY", - "pendingCount": 0, - "createdAt": 1466801808.595, - "desiredCount": 10, - "taskDefinition": "arn:aws:ecs:::task-definition/amazon-ecs-sample:1", - "updatedAt": 1428326312.703, - "id": "ecs-svc/9223370608528463088", - "runningCount": 10 - } - ], - "events": [ - { - "message": "(service my-http-service) has reached a steady state.", - "id": "97c8a8e0-16a5-4d30-80bd-9e5413f8951b", - "createdAt": 1466801812.435 - } - ], - "runningCount": 10 - } - ], - "failures": [] - } + { + "services": [ + { + "status": "ACTIVE", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/amazon-ecs-sample:1", + "pendingCount": 0, + "loadBalancers": [], + "desiredCount": 10, + "createdAt": 1466801808.595, + "serviceName": "my-http-service", + "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/default", + "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/my-http-service", + "deployments": [ + { + "status": "PRIMARY", + "pendingCount": 0, + "createdAt": 1466801808.595, + "desiredCount": 10, + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/amazon-ecs-sample:1", + "updatedAt": 1428326312.703, + "id": "ecs-svc/1234567890123456789", + "runningCount": 10 + } + ], + "events": [ + { + "message": "(service my-http-service) has reached a steady state.", + "id": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "createdAt": 1466801812.435 + } + ], + "runningCount": 10 + } + ], + "failures": [] + } + +For more information, see `Services `_ in the *Amazon ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/describe-task-definition.rst b/bin/awscli/examples/ecs/describe-task-definition.rst index 5f792487..cb018af0 100644 --- a/bin/awscli/examples/ecs/describe-task-definition.rst +++ b/bin/awscli/examples/ecs/describe-task-definition.rst @@ -1,55 +1,55 @@ **To describe a task definition** -This example command provides a description of the specified task definition. +The following ``describe-task-definition`` example retrieves the details of a task definition. :: -Command:: - - aws ecs describe-task-definition --task-definition hello_world:8 + aws ecs describe-task-definition --task-definition hello_world:8 Output:: - { - "taskDefinition": { - "volumes": [], - "taskDefinitionArn": "arn:aws:ecs:us-east-1::task-definition/hello_world:8", - "containerDefinitions": [ - { - "environment": [], - "name": "wordpress", - "links": [ - "mysql" - ], - "mountPoints": [], - "image": "wordpress", - "essential": true, - "portMappings": [ - { - "containerPort": 80, - "hostPort": 80 - } - ], - "memory": 500, - "cpu": 10, - "volumesFrom": [] - }, - { - "environment": [ - { - "name": "MYSQL_ROOT_PASSWORD", - "value": "password" - } - ], - "name": "mysql", - "mountPoints": [], - "image": "mysql", - "cpu": 10, - "portMappings": [], - "memory": 500, - "essential": true, - "volumesFrom": [] - } - ], - "family": "hello_world", - "revision": 8 - } - } + { + "taskDefinition": { + "volumes": [], + "taskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:task-definition/hello_world:8", + "containerDefinitions": [ + { + "environment": [], + "name": "wordpress", + "links": [ + "mysql" + ], + "mountPoints": [], + "image": "wordpress", + "essential": true, + "portMappings": [ + { + "containerPort": 80, + "hostPort": 80 + } + ], + "memory": 500, + "cpu": 10, + "volumesFrom": [] + }, + { + "environment": [ + { + "name": "MYSQL_ROOT_PASSWORD", + "value": "password" + } + ], + "name": "mysql", + "mountPoints": [], + "image": "mysql", + "cpu": 10, + "portMappings": [], + "memory": 500, + "essential": true, + "volumesFrom": [] + } + ], + "family": "hello_world", + "revision": 8 + } + } + +For more information, see `Amazon ECS Task Definitions `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/describe-task-sets.rst b/bin/awscli/examples/ecs/describe-task-sets.rst new file mode 100644 index 00000000..24e657b1 --- /dev/null +++ b/bin/awscli/examples/ecs/describe-task-sets.rst @@ -0,0 +1,48 @@ +**To describe a task set** + +The following ``describe-task-sets`` example describes a task set in a service that uses an external deployer. :: + + aws ecs describe-task-sets \ + --cluster MyCluster \ + --service MyService \ + --task-sets arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789 + +Output:: + + { + "taskSets": [ + { + "id": "ecs-svc/1234567890123456789", + "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", + "status": "ACTIVE", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", + "computedDesiredCount": 0, + "pendingCount": 0, + "runningCount": 0, + "createdAt": 1557207715.195, + "updatedAt": 1557207740.014, + "launchType": "EC2", + "networkConfiguration": { + "awsvpcConfiguration": { + "subnets": [ + "subnet-12344321" + ], + "securityGroups": [ + "sg-1234431" + ], + "assignPublicIp": "DISABLED" + } + }, + "loadBalancers": [], + "serviceRegistries": [], + "scale": { + "value": 0.0, + "unit": "PERCENT" + }, + "stabilityStatus": "STEADY_STATE", + "stabilityStatusAt": 1557207740.014 + } + ], + "failures": [] + } + diff --git a/bin/awscli/examples/ecs/describe-tasks.rst b/bin/awscli/examples/ecs/describe-tasks.rst index 657a36e2..81f9834b 100644 --- a/bin/awscli/examples/ecs/describe-tasks.rst +++ b/bin/awscli/examples/ecs/describe-tasks.rst @@ -1,46 +1,88 @@ **To describe a task** -This example command provides a description of the specified task, using the task UUID as an identifier. +The following ``describe-tasks`` example retrieves the details of a task. You can specify the task by using either the ID or full ARN of the task. :: -Command:: - - aws ecs describe-tasks --tasks c5cba4eb-5dad-405e-96db-71ef8eefe6a8 + aws ecs describe-tasks \ + --cluster MyCluster \ + --tasks arn:aws:ecs:us-west-2:123456789012:task/MyCluster/1234567890123456789 Output:: - { - "failures": [], - "tasks": [ - { - "taskArn": "arn:aws:ecs:::task/c5cba4eb-5dad-405e-96db-71ef8eefe6a8", - "overrides": { - "containerOverrides": [ - { - "name": "ecs-demo" - } - ] - }, - "lastStatus": "RUNNING", - "containerInstanceArn": "arn:aws:ecs:::container-instance/18f9eda5-27d7-4c19-b133-45adc516e8fb", - "clusterArn": "arn:aws:ecs:::cluster/default", - "desiredStatus": "RUNNING", - "taskDefinitionArn": "arn:aws:ecs:::task-definition/amazon-ecs-sample:1", - "startedBy": "ecs-svc/9223370608528463088", - "containers": [ - { - "containerArn": "arn:aws:ecs:::container/7c01765b-c588-45b3-8290-4ba38bd6c5a6", - "taskArn": "arn:aws:ecs:::task/c5cba4eb-5dad-405e-96db-71ef8eefe6a8", - "lastStatus": "RUNNING", - "name": "ecs-demo", - "networkBindings": [ - { - "bindIP": "0.0.0.0", - "containerPort": 80, - "hostPort": 80 - } - ] - } - ] - } - ] - } + { + "tasks": [ + { + "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/MyCluster/1234567890123456789", + "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", + "taskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", + "overrides": { + "containerOverrides": [ + { + "name": "fargate-app" + } + ] + }, + "lastStatus": "RUNNING", + "desiredStatus": "RUNNING", + "cpu": "256", + "memory": "512", + "containers": [ + { + "containerArn": "arn:aws:ecs:us-west-2:123456789012:container/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/MyCluster/1234567890123456789", + "name": "fargate-app", + "lastStatus": "RUNNING", + "networkBindings": [], + "networkInterfaces": [ + { + "attachmentId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", + "privateIpv4Address": "10.0.0.4" + } + ], + "healthStatus": "UNKNOWN", + "cpu": "0" + } + ], + "startedBy": "ecs-svc/1234567890123456789", + "version": 3, + "connectivity": "CONNECTED", + "connectivityAt": 1557134016.971, + "pullStartedAt": 1557134025.379, + "pullStoppedAt": 1557134033.379, + "createdAt": 1557134011.644, + "startedAt": 1557134035.379, + "group": "service:fargate-service", + "launchType": "FARGATE", + "platformVersion": "1.3.0", + "attachments": [ + { + "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", + "type": "ElasticNetworkInterface", + "status": "ATTACHED", + "details": [ + { + "name": "subnetId", + "value": "subnet-12344321" + }, + { + "name": "networkInterfaceId", + "value": "eni-12344321" + }, + { + "name": "macAddress", + "value": "0a:90:09:84:f9:14" + }, + { + "name": "privateIPv4Address", + "value": "10.0.0.4" + } + ] + } + ], + "healthStatus": "UNKNOWN", + "tags": [] + } + ], + "failures": [] + } + +For more information, see `Amazon ECS Task Definitions `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/list-account-settings.rst b/bin/awscli/examples/ecs/list-account-settings.rst new file mode 100644 index 00000000..397e02b3 --- /dev/null +++ b/bin/awscli/examples/ecs/list-account-settings.rst @@ -0,0 +1,47 @@ +**Example 1: To view the account settings for an account** + +The following ``list-account-settings`` example displays the effective account settings for an account. :: + + aws ecs list-account-settings --effective-settings + +Output:: + + { + "settings": [ + { + "name": "containerInstanceLongArnFormat", + "value": "enabled", + "principalArn": "arn:aws:iam::123456789012:root" + }, + { + "name": "serviceLongArnFormat", + "value": "enabled", + "principalArn": "arn:aws:iam::123456789012:root" + }, + { + "name": "taskLongArnFormat", + "value": "enabled", + "principalArn": "arn:aws:iam::123456789012:root" + } + ] + } + +**Example 2: To view the account settings for a specific IAM user or IAM role** + +The following ``list-account-settings`` example displays the account settings for the specified IAM user or IAM role. :: + + aws ecs list-account-settings --principal-arn arn:aws:iam::123456789012:user/MyUser + +Output:: + + { + "settings": [ + { + "name": "serviceLongArnFormat", + "value": "enabled", + "principalArn": "arn:aws:iam::123456789012:user/MyUser" + } + ] + } + +For more information, see `Amazon Resource Names (ARNs) and IDs `_ in the *Amazon ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/list-clusters.rst b/bin/awscli/examples/ecs/list-clusters.rst index 9e61168f..d020efcb 100644 --- a/bin/awscli/examples/ecs/list-clusters.rst +++ b/bin/awscli/examples/ecs/list-clusters.rst @@ -1,16 +1,16 @@ **To list your available clusters** -This example command lists all of your available clusters in your default region. +The following ``list-clusters`` example lists all of the available clusters. :: -Command:: - - aws ecs list-clusters + aws ecs list-clusters Output:: - { - "clusterArns": [ - "arn:aws:ecs:us-east-1::cluster/test", - "arn:aws:ecs:us-east-1::cluster/default" - ] - } + { + "clusterArns": [ + "arn:aws:ecs:us-west-2:123456789012:cluster/MyECSCluster1", + "arn:aws:ecs:us-west-2:123456789012:cluster/AnotherECSCluster" + ] + } + +For more information, see `Amazon ECS Clusters `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/list-container-instances.rst b/bin/awscli/examples/ecs/list-container-instances.rst index 6aa19570..f7682309 100644 --- a/bin/awscli/examples/ecs/list-container-instances.rst +++ b/bin/awscli/examples/ecs/list-container-instances.rst @@ -1,16 +1,16 @@ -**To list your available container instances in a cluster** +**To list the container instances in a cluster** -This example command lists all of your available container instances in the specified cluster (`my_cluster`) in your default region. +The following ``list-container-instances`` example lists all of the available container instances in a cluster. :: -Command:: - - aws ecs list-container-instances --cluster my_cluster + aws ecs list-container-instances --cluster MyCluster 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" - ] - } + { + "containerInstanceArns": [ + "arn:aws:ecs:us-west-2:123456789012:container-instance/MyCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "arn:aws:ecs:us-west-2:123456789012:container-instance/MyCluster/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" + ] + } + +For more information, see `Amazon ECS Container Instances `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/list-services.rst b/bin/awscli/examples/ecs/list-services.rst index e64c25f7..22ed2e31 100644 --- a/bin/awscli/examples/ecs/list-services.rst +++ b/bin/awscli/examples/ecs/list-services.rst @@ -1,15 +1,15 @@ **To list the services in a cluster** -This example command lists the services running in a cluster. +The following ``list-services`` example shows how to list the services running in a cluster. :: -Command:: - - aws ecs list-services + aws ecs list-services --cluster MyCluster Output:: - { - "serviceArns": [ - "arn:aws:ecs:::service/my-http-service" - ] - } + { + "serviceArns": [ + "arn:aws:ecs:us-west-2:123456789012:service/MyCluster/MyService" + ] + } + +For more information, see `Services `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/list-tags-for-resource.rst b/bin/awscli/examples/ecs/list-tags-for-resource.rst new file mode 100644 index 00000000..eb4841a9 --- /dev/null +++ b/bin/awscli/examples/ecs/list-tags-for-resource.rst @@ -0,0 +1,25 @@ +**To list the tags for a resource** + +The following ``list-tags-for-resource`` example lists the tags for a specific cluster. :: + + aws ecs list-tags-for-resource \ + --resource-arn arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster + +Output:: + + { + "tags": [ + { + "key": "key1", + "value": "value1" + }, + { + "key": "key2", + "value": "value2" + }, + { + "key": "key3", + "value": "value3" + } + ] + } diff --git a/bin/awscli/examples/ecs/list-task-definition-families.rst b/bin/awscli/examples/ecs/list-task-definition-families.rst index 634c4755..397d4247 100644 --- a/bin/awscli/examples/ecs/list-task-definition-families.rst +++ b/bin/awscli/examples/ecs/list-task-definition-families.rst @@ -1,35 +1,33 @@ -**To list your registered task definition families** +**Example 1: To list the registered task definition families** -This example command lists all of your registered task definition families. +The following ``list-task-definition-families`` example lists all of the registered task definition families. :: -Command:: - - aws ecs list-task-definition-families + aws ecs list-task-definition-families Output:: - { - "families": [ - "node-js-app", - "web-timer", - "hpcc", - "hpcc-c4-8xlarge" - ] - } - -**To filter your registered task definition families** + { + "families": [ + "node-js-app", + "web-timer", + "hpcc", + "hpcc-c4-8xlarge" + ] + } -This example command lists the task definition revisions that start with "hpcc". +**Example 2: To filter the registered task definition families** -Command:: +The following ``list-task-definition-families`` example lists the task definition revisions that start with "hpcc". :: - aws ecs list-task-definition-families --family-prefix hpcc + aws ecs list-task-definition-families --family-prefix hpcc Output:: - { - "families": [ - "hpcc", - "hpcc-c4-8xlarge" - ] - } + { + "families": [ + "hpcc", + "hpcc-c4-8xlarge" + ] + } + +For more information, see `Task Definition Parameters `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/list-task-definitions.rst b/bin/awscli/examples/ecs/list-task-definitions.rst index a7e8fd7d..351ca46c 100644 --- a/bin/awscli/examples/ecs/list-task-definitions.rst +++ b/bin/awscli/examples/ecs/list-task-definitions.rst @@ -1,39 +1,37 @@ -**To list your registered task definitions** +**Example 1: To list the registered task definitions** -This example command lists all of your registered task definitions. +The following ``list-task-definitions`` example lists all of the registered task definitions. :: -Command:: - - aws ecs list-task-definitions + aws ecs list-task-definitions 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" - ] - } - -**To list the registered task definitions in a family** + { + "taskDefinitionArns": [ + "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep300:2", + "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep360:1", + "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:3", + "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:4", + "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:5", + "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:6" + ] + } -This example command lists the task definition revisions of a specified family. +**Example 2: To list the registered task definitions in a family** -Command:: +The following `list-task-definitions` example lists the task definition revisions of a specified family. :: - aws ecs list-task-definitions --family-prefix wordpress + aws ecs list-task-definitions --family-prefix 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" - ] - } \ No newline at end of file + { + "taskDefinitionArns": [ + "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:3", + "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:4", + "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:5", + "arn:aws:ecs:us-west-2:123456789012:task-definition/wordpress:6" + ] + } + +For more information, see `Amazon ECS Task Definitions `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/list-tasks.rst b/bin/awscli/examples/ecs/list-tasks.rst index d35e8c35..42a6837f 100644 --- a/bin/awscli/examples/ecs/list-tasks.rst +++ b/bin/awscli/examples/ecs/list-tasks.rst @@ -1,32 +1,30 @@ -**To list the tasks in a cluster** +**Example 1: To list the tasks in a cluster** -This example command lists all of the tasks in a cluster. +The following ``list-tasks`` example lists all of the tasks in a cluster. :: -Command:: - - aws ecs list-tasks --cluster default + aws ecs list-tasks --cluster default Output:: - { - "taskArns": [ - "arn:aws:ecs:us-east-1::task/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84", - "arn:aws:ecs:us-east-1::task/6b809ef6-c67e-4467-921f-ee261c15a0a1" - ] - } - -**To list the tasks on a particular container instance** + { + "taskArns": [ + "arn:aws:ecs:us-west-2:123456789012:task/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", + "arn:aws:ecs:us-west-2:123456789012:task/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" + ] + } -This example command lists the tasks of a specified container instance, using the container instance UUID as a filter. +**Example 2: To list the tasks on a particular container instance** -Command:: +The following ``list-tasks`` example lists the tasks on a container instance, using the container instance UUID as a filter. :: - aws ecs list-tasks --cluster default --container-instance f6bbb147-5370-4ace-8c73-c7181ded911f + aws ecs list-tasks --cluster default --container-instance a1b2c3d4-5678-90ab-cdef-33333EXAMPLE Output:: - { - "taskArns": [ - "arn:aws:ecs:us-east-1::task/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84" - ] - } \ No newline at end of file + { + "taskArns": [ + "arn:aws:ecs:us-west-2:123456789012:task/a1b2c3d4-5678-90ab-cdef-44444EXAMPLE" + ] + } + +For more information, see `Amazon ECS Task Definitions `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/put-account-setting-default.rst b/bin/awscli/examples/ecs/put-account-setting-default.rst new file mode 100644 index 00000000..821d7258 --- /dev/null +++ b/bin/awscli/examples/ecs/put-account-setting-default.rst @@ -0,0 +1,17 @@ +**To modify the default account settings** + +The following ``put-account-setting-default`` example modifies the default account setting for all IAM users or roles on your account. These changes apply to the entire AWS account unless an IAM user or role explicitly overrides these settings for themselves. :: + + aws ecs put-account-setting-default --name serviceLongArnFormat --value enabled + +Output:: + + { + "setting": { + "name": "serviceLongArnFormat", + "value": "enabled", + "principalArn": "arn:aws:iam::123456789012:root" + } + } + +For more information, see `Amazon Resource Names (ARNs) and IDs `_ in the *Amazon ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/put-account-settings.rst b/bin/awscli/examples/ecs/put-account-settings.rst new file mode 100644 index 00000000..7f3a49b6 --- /dev/null +++ b/bin/awscli/examples/ecs/put-account-settings.rst @@ -0,0 +1,19 @@ +**To modify the account settings for an IAM user or IAM role** + +The following ``put-account-setting`` example modifies the account settings for the specified IAM user or IAM role. :: + + aws ecs put-account-setting \ + --name serviceLongArnFormat \ + --value enabled \ + --principal-arn arn:aws:iam::123456789012:user/MyUser + +Output:: + + { + "setting": { + "name": "serviceLongArnFormat", + "value": "enabled", + "principalArn": "arn:aws:iam::123456789012:user/MyUser" + } + } + diff --git a/bin/awscli/examples/ecs/register-task-definition.rst b/bin/awscli/examples/ecs/register-task-definition.rst index 118d4a0b..b796e4b7 100644 --- a/bin/awscli/examples/ecs/register-task-definition.rst +++ b/bin/awscli/examples/ecs/register-task-definition.rst @@ -1,108 +1,123 @@ -**To register a task definition with a JSON file** - -This example registers a task definition to the specified family with container definitions that are saved in JSON format at the specified file location. - -Command:: - - aws ecs register-task-definition --cli-input-json file:///sleep360.json - -JSON file format:: - - { - "containerDefinitions": [ - { - "name": "sleep", - "image": "busybox", - "cpu": 10, - "command": [ - "sleep", - "360" +**Example 1: To register a task definition with a JSON file** + +The following ``register-task-definition`` example registers a task definition to the specified family with container definitions that are saved in JSON format at the specified file location. :: + + aws ecs register-task-definition \ + --cli-input-json file:///sleep360.json + +``sleep360.json`` file contents:: + + { + "containerDefinitions": [ + { + "name": "sleep", + "image": "busybox", + "cpu": 10, + "command": [ + "sleep", + "360" + ], + "memory": 10, + "essential": true + } ], - "memory": 10, - "essential": true - } - ], - "family": "sleep360" - } + "family": "sleep360" + } Output:: - { - "taskDefinition": { - "volumes": [], - "taskDefinitionArn": "arn:aws:ecs:us-east-1::task-definition/sleep360:19", - "containerDefinitions": [ - { - "environment": [], - "name": "sleep", - "mountPoints": [], - "image": "busybox", - "cpu": 10, - "portMappings": [], - "command": [ - "sleep", - "360" - ], - "memory": 10, - "essential": true, - "volumesFrom": [] - } - ], - "family": "sleep360", - "revision": 1 - } - } - -**To register a task definition with a JSON string** - -This example registers a the same task definition from the previous example, but the container definitions are in a string format with the double quotes escaped. - -Command:: - - aws ecs register-task-definition --family sleep360 --container-definitions "[{\"name\":\"sleep\",\"image\":\"busybox\",\"cpu\":10,\"command\":[\"sleep\",\"360\"],\"memory\":10,\"essential\":true}]" - -**To use data volumes in a task definition** - -This example task definition creates a data volume called `webdata` that exists at `/ecs/webdata` on the container instance. The volume is mounted read-only as `/usr/share/nginx/html` on the `web` container, and read-write as `/nginx/` on the `timer` container. - -Task Definition:: - - { - "family": "web-timer", - "containerDefinitions": [ - { - "name": "web", - "image": "nginx", - "cpu": 99, - "memory": 100, - "portMappings": [{ - "containerPort": 80, - "hostPort": 80 - }], - "essential": true, - "mountPoints": [{ - "sourceVolume": "webdata", - "containerPath": "/usr/share/nginx/html", - "readOnly": true - }] - }, { - "name": "timer", - "image": "busybox", - "cpu": 10, - "memory": 20, - "entryPoint": ["sh", "-c"], - "command": ["while true; do date > /nginx/index.html; sleep 1; done"], - "mountPoints": [{ - "sourceVolume": "webdata", - "containerPath": "/nginx/" - }] - }], - "volumes": [{ - "name": "webdata", - "host": { - "sourcePath": "/ecs/webdata" - }} - ] - } - - + { + "taskDefinition": { + "taskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep360:2", + "containerDefinitions": [ + { + "name": "sleep", + "image": "busybox", + "cpu": 10, + "memory": 10, + "portMappings": [], + "essential": true, + "command": [ + "sleep", + "360" + ], + "environment": [], + "mountPoints": [], + "volumesFrom": [] + } + ], + "family": "sleep360", + "revision": 2, + "volumes": [], + "status": "ACTIVE", + "placementConstraints": [], + "compatibilities": [ + "EC2" + ] + } + } + +**Example 2: To register a task definition with a JSON string parameter** + +The following ``register-task-definition`` example registers the same task definition from the previous example, but the container definitions are provided as a string parameter with the double quotes escaped. :: + + aws ecs register-task-definition \ + --family sleep360 \ + --container-definitions "[{\"name\":\"sleep\",\"image\":\"busybox\",\"cpu\":10,\"command\":[\"sleep\",\"360\"],\"memory\":10,\"essential\":true}]" + +The output is identical to the previous example. + +**Example 3: To use data volumes in a task definition** + +This example task definition file creates a data volume called `webdata` that exists at `/ecs/webdata` on the container instance. The volume is mounted read-only as `/usr/share/nginx/html` on the `web` container, and read-write as `/nginx/` on the `timer` container. :: + + { + "family": "web-timer", + "containerDefinitions": [ + { + "name": "web", + "image": "nginx", + "cpu": 99, + "memory": 100, + "portMappings": [ + { + "containerPort": 80, + "hostPort": 80 + } + ], + "essential": true, + "mountPoints": [ + { + "sourceVolume": "webdata", + "containerPath": "/usr/share/nginx/html", + "readOnly": true + } + ] + }, + { + "name": "timer", + "image": "busybox", + "cpu": 10, + "memory": 20, + "entryPoint": ["sh", "-c"], + "command": ["while true; do date > /nginx/index.html; sleep 1; done"], + "mountPoints": [ + { + "sourceVolume": "webdata", + "containerPath": "/nginx/" + } + ] + } + ], + "volumes": [ + { + "name": "webdata", + "host": { + "sourcePath": "/ecs/webdata" + } + } + ] + } + + +For more information, see `Creating a Task Definition `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/run-task.rst b/bin/awscli/examples/ecs/run-task.rst index a68ba0bf..745a9a75 100644 --- a/bin/awscli/examples/ecs/run-task.rst +++ b/bin/awscli/examples/ecs/run-task.rst @@ -1,36 +1,37 @@ **To run a task on your default cluster** -This example command runs the specified task definition on your default cluster. +The following ``run-task`` example runs a task on the default cluster. :: -Command:: - - aws ecs run-task --cluster default --task-definition sleep360:1 + aws ecs run-task --cluster default --task-definition sleep360:1 Output:: - { - "tasks": [ - { - "taskArn": "arn:aws:ecs:us-east-1::task/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0", - "overrides": { - "containerOverrides": [ - { - "name": "sleep" - } - ] - }, - "lastStatus": "PENDING", - "containerInstanceArn": "arn:aws:ecs:us-east-1::container-instance/ffe3d344-77e2-476c-a4d0-bf560ad50acb", - "desiredStatus": "RUNNING", - "taskDefinitionArn": "arn:aws:ecs:us-east-1::task-definition/sleep360:1", - "containers": [ - { - "containerArn": "arn:aws:ecs:us-east-1::container/58591c8e-be29-4ddf-95aa-ee459d4c59fd", - "taskArn": "arn:aws:ecs:us-east-1::task/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0", - "lastStatus": "PENDING", - "name": "sleep" - } - ] - } - ] - } + { + "tasks": [ + { + "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/a1b2c3d4-5678-90ab-ccdef-11111EXAMPLE", + "overrides": { + "containerOverrides": [ + { + "name": "sleep" + } + ] + }, + "lastStatus": "PENDING", + "containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/a1b2c3d4-5678-90ab-ccdef-22222EXAMPLE", + "desiredStatus": "RUNNING", + "taskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:task-definition/sleep360:1", + "containers": [ + { + "containerArn": "arn:aws:ecs:us-west-2:123456789012:container/a1b2c3d4-5678-90ab-ccdef-33333EXAMPLE", + "taskArn": "arn:aws:ecs:us-west-2:123456789012:task/a1b2c3d4-5678-90ab-ccdef-11111EXAMPLE", + "lastStatus": "PENDING", + "name": "sleep" + } + ] + } + ] + } + + +For more information, see `Running Tasks `_ in the *Amazon ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/tag-resource.rst b/bin/awscli/examples/ecs/tag-resource.rst new file mode 100644 index 00000000..e6a783e3 --- /dev/null +++ b/bin/awscli/examples/ecs/tag-resource.rst @@ -0,0 +1,19 @@ +**To tag a resource** + +The following ``tag-resource`` example adds a single tag to the specified resource. :: + + aws ecs tag-resource \ + --resource-arn arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster + --tags key=key1,value=value1 + +This command produces no output. + +**To add multiple tags to a resource** + +The following ``tag-resource`` example adds multiple tags to the specified resource. :: + + aws ecs tag-resource \ + --resource-arn arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster \ + --tags key=key1,value=value1 key=key2,value=value2 key=key3,value=value3 + +This command produces no output. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/untag-resource.rst b/bin/awscli/examples/ecs/untag-resource.rst new file mode 100644 index 00000000..0cc00912 --- /dev/null +++ b/bin/awscli/examples/ecs/untag-resource.rst @@ -0,0 +1,10 @@ +**To remove a tag from a resource** + +The following ``untag-resource`` example removes the listed tags from the specified resource. :: + + aws ecs untag-resource \ + --resource-arn arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster \ + --tag-keys key1,key2 + +This command produces no output. + diff --git a/bin/awscli/examples/ecs/update-container-agent.rst b/bin/awscli/examples/ecs/update-container-agent.rst index 2cecf991..f0267984 100644 --- a/bin/awscli/examples/ecs/update-container-agent.rst +++ b/bin/awscli/examples/ecs/update-container-agent.rst @@ -1,22 +1,22 @@ **To update the container agent on an Amazon ECS container instance** -This example command updates the container agent on the container instance ``a3e98c65-2a40-4452-a63c-62beb4d9be9b`` in the default cluster. +The following ``update-container-agent`` example updates the container agent on the specified container instance in the default cluster. :: -Command:: - - aws ecs update-container-agent --cluster default --container-instance a3e98c65-2a40-4452-a63c-62beb4d9be9b + aws ecs update-container-agent --cluster default --container-instance a1b2c3d4-5678-90ab-cdef-11111EXAMPLE Output:: - { - "containerInstance": { - "status": "ACTIVE", - ... - "agentUpdateStatus": "PENDING", - "versionInfo": { - "agentVersion": "1.0.0", - "agentHash": "4023248", - "dockerVersion": "DockerVersion: 1.5.0" - } - } - } \ No newline at end of file + { + "containerInstance": { + "status": "ACTIVE", + ... + "agentUpdateStatus": "PENDING", + "versionInfo": { + "agentVersion": "1.0.0", + "agentHash": "4023248", + "dockerVersion": "DockerVersion: 1.5.0" + } + } + } + +For more information, see `Updating the Amazon ECS Container Agent `_ in the *Amazon ECS Developer Guide*. diff --git a/bin/awscli/examples/ecs/update-service-primary-task-set.rst b/bin/awscli/examples/ecs/update-service-primary-task-set.rst new file mode 100644 index 00000000..80310e3e --- /dev/null +++ b/bin/awscli/examples/ecs/update-service-primary-task-set.rst @@ -0,0 +1,44 @@ +**To update the primary task set for a service** + +The following ``update-service-primary-task-set`` example updates the primary task set for the specified service. :: + + aws ecs update-service-primary-task-set \ + --cluster MyCluster \ + --service MyService \ + --primary-task-set arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789 + +Output:: + + { + "taskSet": { + "id": "ecs-svc/1234567890123456789", + "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", + "status": "PRIMARY", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", + "computedDesiredCount": 1, + "pendingCount": 0, + "runningCount": 0, + "createdAt": 1557128360.711, + "updatedAt": 1557129412.653, + "launchType": "EC2", + "networkConfiguration": { + "awsvpcConfiguration": { + "subnets": [ + "subnet-12344321" + ], + "securityGroups": [ + "sg-12344312" + ], + "assignPublicIp": "DISABLED" + } + }, + "loadBalancers": [], + "serviceRegistries": [], + "scale": { + "value": 50.0, + "unit": "PERCENT" + }, + "stabilityStatus": "STABILIZING", + "stabilityStatusAt": 1557129279.914 + } + } diff --git a/bin/awscli/examples/ecs/update-service.rst b/bin/awscli/examples/ecs/update-service.rst index 38060643..ac872373 100644 --- a/bin/awscli/examples/ecs/update-service.rst +++ b/bin/awscli/examples/ecs/update-service.rst @@ -1,15 +1,13 @@ -**To change the task definition used in a service** +**Example 1: To change the task definition used in a service** -This example command updates the ``my-http-service`` service to use the ``amazon-ecs-sample`` task definition. +The following ``update-service`` example updates the ``my-http-service`` service to use the ``amazon-ecs-sample`` task definition. :: -Command:: + aws ecs update-service --service my-http-service --task-definition amazon-ecs-sample - aws ecs update-service --service my-http-service --task-definition amazon-ecs-sample +**Example 2: To change the number of tasks in a service** -**To change the number of tasks in a service** +The following ``update-service`` example updates the desired task count of the service ``my-http-service`` to 3. :: -This example command updates the desired count of the ``my-http-service`` service to 10. + aws ecs update-service --service my-http-service --desired-count 3 -Command:: - - aws ecs update-service --service my-http-service --desired-count 10 \ No newline at end of file +For more information, see `Updating a Service `_ in the *Amazon ECS Developer Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/ecs/update-task-set.rst b/bin/awscli/examples/ecs/update-task-set.rst new file mode 100644 index 00000000..cd03947d --- /dev/null +++ b/bin/awscli/examples/ecs/update-task-set.rst @@ -0,0 +1,45 @@ +**To update a task set** + +The following ``update-task-set`` example updates a task set to adjust the scale. :: + + aws ecs update-task-set \ + --cluster MyCluster \ + --service MyService \ + --task-set arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789 \ + --scale value=50,unit=PERCENT + +Output:: + + { + "taskSet": { + "id": "ecs-svc/1234567890123456789", + "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", + "status": "ACTIVE", + "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", + "computedDesiredCount": 0, + "pendingCount": 0, + "runningCount": 0, + "createdAt": 1557128360.711, + "updatedAt": 1557129279.914, + "launchType": "EC2", + "networkConfiguration": { + "awsvpcConfiguration": { + "subnets": [ + "subnet-12344321" + ], + "securityGroups": [ + "sg-12344321" + ], + "assignPublicIp": "DISABLED" + } + }, + "loadBalancers": [], + "serviceRegistries": [], + "scale": { + "value": 50.0, + "unit": "PERCENT" + }, + "stabilityStatus": "STABILIZING", + "stabilityStatusAt": 1557129279.914 + } + } diff --git a/bin/awscli/examples/eks/update-kubeconfig/_description.rst b/bin/awscli/examples/eks/update-kubeconfig/_description.rst index 457d7856..7f978eb1 100644 --- a/bin/awscli/examples/eks/update-kubeconfig/_description.rst +++ b/bin/awscli/examples/eks/update-kubeconfig/_description.rst @@ -1,7 +1,7 @@ Configures kubectl so that you can connect to an Amazon EKS cluster. Note: - To use the resulting configuration, you must have kubectl and the aws-iam-authenticator installed and in your PATH environment variable. + To use the resulting configuration, you must have kubectl installed and in your PATH environment variable. This command constructs a configuration with prepopulated server and certificate authority data values for a specified cluster. You can specify an IAM role ARN with the --role-arn option to use for authentication when you issue kubectl commands. diff --git a/bin/awscli/examples/elastictranscoder/cancel-job.rst b/bin/awscli/examples/elastictranscoder/cancel-job.rst new file mode 100644 index 00000000..4acd71e6 --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/cancel-job.rst @@ -0,0 +1,8 @@ +**To cancel a job for ElasticTranscoder** + +This cancels the specified job for ElasticTranscoder. + +Command:: + + aws elastictranscoder cancel-job --id 3333333333333-abcde3 + diff --git a/bin/awscli/examples/elastictranscoder/create-job.rst b/bin/awscli/examples/elastictranscoder/create-job.rst new file mode 100644 index 00000000..6b10d1a2 --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/create-job.rst @@ -0,0 +1,94 @@ +**To create a job for ElasticTranscoder** + +The following ``create-job`` example creates a job for ElasticTranscoder. :: + + aws elastictranscoder create-job \ + --pipeline-id 1111111111111-abcde1 \ + --inputs file://inputs.json \ + --outputs file://outputs.json \ + --output-key-prefix "recipes/" \ + --user-metadata file://user-metadata.json + +Contents of ``inputs.json``:: + + [{ + "Key":"ETS_example_file.mp4", + "FrameRate":"auto", + "Resolution":"auto", + "AspectRatio":"auto", + "Interlaced":"auto", + "Container":"mp4" + }] + +Contents of outputs.json:: + + [ + { + "Key":"webm/ETS_example_file-kindlefirehd.webm", + "Rotate":"0", + "PresetId":"1351620000001-100250" + } + ] + +Contents of ``user-metadata.json``:: + + { + "Food type":"Italian", + "Cook book":"recipe notebook" + } + +Output:: + + { + "Job": { + "Status": "Submitted", + "Inputs": [ + { + "Container": "mp4", + "FrameRate": "auto", + "Key": "ETS_example_file.mp4", + "AspectRatio": "auto", + "Resolution": "auto", + "Interlaced": "auto" + } + ], + "Playlists": [], + "Outputs": [ + { + "Status": "Submitted", + "Rotate": "0", + "PresetId": "1351620000001-100250", + "Watermarks": [], + "Key": "webm/ETS_example_file-kindlefirehd.webm", + "Id": "1" + } + ], + "PipelineId": "3333333333333-abcde3", + "OutputKeyPrefix": "recipes/", + "UserMetadata": { + "Cook book": "recipe notebook", + "Food type": "Italian" + }, + "Output": { + "Status": "Submitted", + "Rotate": "0", + "PresetId": "1351620000001-100250", + "Watermarks": [], + "Key": "webm/ETS_example_file-kindlefirehd.webm", + "Id": "1" + }, + "Timing": { + "SubmitTimeMillis": 1533838012298 + }, + "Input": { + "Container": "mp4", + "FrameRate": "auto", + "Key": "ETS_example_file.mp4", + "AspectRatio": "auto", + "Resolution": "auto", + "Interlaced": "auto" + }, + "Id": "1533838012294-example", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:job/1533838012294-example" + } + } diff --git a/bin/awscli/examples/elastictranscoder/create-pipeline.rst b/bin/awscli/examples/elastictranscoder/create-pipeline.rst new file mode 100644 index 00000000..16aeb5b2 --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/create-pipeline.rst @@ -0,0 +1,95 @@ + +**To create a pipeline for ElasticTranscoder** + +The following ``create-pipeline`` example creates a pipeline for ElasticTranscoder. :: + + aws elastictranscoder create-pipeline \ + --name Default \ + --input-bucket salesoffice.example.com-source \ + --role arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role \ + --notifications Progressing="",Completed="",Warning="",Error=arn:aws:sns:us-east-1:111222333444:ETS_Errors \ + --content-config file://content-config.json \ + --thumbnail-config file://thumbnail-config.json + +Contents of ``content-config.json``:: + + { + "Bucket":"salesoffice.example.com-public-promos", + "Permissions":[ + { + "GranteeType":"Email", + "Grantee":"marketing-promos@example.com", + "Access":[ + "FullControl" + ] + } + ], + "StorageClass":"Standard" + } + +Contents of ``thumbnail-config.json``:: + + { + "Bucket":"salesoffice.example.com-public-promos-thumbnails", + "Permissions":[ + { + "GranteeType":"Email", + "Grantee":"marketing-promos@example.com", + "Access":[ + "FullControl" + ] + } + ], + "StorageClass":"ReducedRedundancy" + } + +Output:: + + { + "Pipeline": { + "Status": "Active", + "ContentConfig": { + "Bucket": "salesoffice.example.com-public-promos", + "StorageClass": "Standard", + "Permissions": [ + { + "Access": [ + "FullControl" + ], + "Grantee": "marketing-promos@example.com", + "GranteeType": "Email" + } + ] + }, + "Name": "Default", + "ThumbnailConfig": { + "Bucket": "salesoffice.example.com-public-promos-thumbnails", + "StorageClass": "ReducedRedundancy", + "Permissions": [ + { + "Access": [ + "FullControl" + ], + "Grantee": "marketing-promos@example.com", + "GranteeType": "Email" + } + ] + }, + "Notifications": { + "Completed": "", + "Warning": "", + "Progressing": "", + "Error": "arn:aws:sns:us-east-1:123456789012:ETS_Errors" + }, + "Role": "arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", + "InputBucket": "salesoffice.example.com-source", + "Id": "1533765810590-example", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:pipeline/1533765810590-example" + }, + "Warnings": [ + { + "Message": "The SNS notification topic for Error events and the pipeline are in different regions, which increases processing time for jobs in the pipeline and can incur additional charges. To decrease processing time and prevent cross-regional charges, use the same region for the SNS notification topic and the pipeline.", + "Code": "6006" + } + ] + } diff --git a/bin/awscli/examples/elastictranscoder/create-preset.rst b/bin/awscli/examples/elastictranscoder/create-preset.rst new file mode 100644 index 00000000..1e229953 --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/create-preset.rst @@ -0,0 +1,142 @@ + +**To create a preset for ElasticTranscoder** + +The following ``create-preset`` example creates a preset for ElasticTranscoder. :: + + aws elastictranscoder create-preset \ + --name DefaultPreset \ + --description "Use for published videos" \ + --container mp4 \ + --video file://video.json \ + --audio file://audio.json \ + --thumbnails file://thumbnails.json + +Contents of ``video.json``:: + + { + "Codec":"H.264", + "CodecOptions":{ + "Profile":"main", + "Level":"2.2", + "MaxReferenceFrames":"3", + "MaxBitRate":"", + "BufferSize":"", + "InterlacedMode":"Progressive", + "ColorSpaceConversionMode":"None" + }, + "KeyframesMaxDist":"240", + "FixedGOP":"false", + "BitRate":"1600", + "FrameRate":"auto", + "MaxFrameRate":"30", + "MaxWidth":"auto", + "MaxHeight":"auto", + "SizingPolicy":"Fit", + "PaddingPolicy":"Pad", + "DisplayAspectRatio":"auto", + "Watermarks":[ + { + "Id":"company logo", + "MaxWidth":"20%", + "MaxHeight":"20%", + "SizingPolicy":"ShrinkToFit", + "HorizontalAlign":"Right", + "HorizontalOffset":"10px", + "VerticalAlign":"Bottom", + "VerticalOffset":"10px", + "Opacity":"55.5", + "Target":"Content" + } + ] + } + +Contents of ``audio.json``:: + + { + "Codec":"AAC", + "CodecOptions":{ + "Profile":"AAC-LC" + }, + "SampleRate":"44100", + "BitRate":"96", + "Channels":"2" + } + +Contents of ``thumbnails.json``:: + + { + "Format":"png", + "Interval":"120", + "MaxWidth":"auto", + "MaxHeight":"auto", + "SizingPolicy":"Fit", + "PaddingPolicy":"Pad" + } + + +Output:: + + { + "Preset": { + "Thumbnails": { + "SizingPolicy": "Fit", + "MaxWidth": "auto", + "Format": "png", + "PaddingPolicy": "Pad", + "Interval": "120", + "MaxHeight": "auto" + }, + "Container": "mp4", + "Description": "Use for published videos", + "Video": { + "SizingPolicy": "Fit", + "MaxWidth": "auto", + "PaddingPolicy": "Pad", + "MaxFrameRate": "30", + "FrameRate": "auto", + "MaxHeight": "auto", + "KeyframesMaxDist": "240", + "FixedGOP": "false", + "Codec": "H.264", + "Watermarks": [ + { + "SizingPolicy": "ShrinkToFit", + "VerticalOffset": "10px", + "VerticalAlign": "Bottom", + "Target": "Content", + "MaxWidth": "20%", + "MaxHeight": "20%", + "HorizontalAlign": "Right", + "HorizontalOffset": "10px", + "Opacity": "55.5", + "Id": "company logo" + } + ], + "CodecOptions": { + "Profile": "main", + "MaxBitRate": "32", + "InterlacedMode": "Progressive", + "Level": "2.2", + "ColorSpaceConversionMode": "None", + "MaxReferenceFrames": "3", + "BufferSize": "5" + }, + "BitRate": "1600", + "DisplayAspectRatio": "auto" + }, + "Audio": { + "Channels": "2", + "CodecOptions": { + "Profile": "AAC-LC" + }, + "SampleRate": "44100", + "Codec": "AAC", + "BitRate": "96" + }, + "Type": "Custom", + "Id": "1533765290724-example" + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:preset/1533765290724-example", + "Name": "DefaultPreset" + }, + "Warning": "" + } diff --git a/bin/awscli/examples/elastictranscoder/delete-pipeline.rst b/bin/awscli/examples/elastictranscoder/delete-pipeline.rst new file mode 100644 index 00000000..2ccfc95c --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/delete-pipeline.rst @@ -0,0 +1,13 @@ +**To delete the specified ElasticTranscoder pipeline** + +This deletes the specified ElasticTranscoder pipeline. + +Command:: + + aws elastictranscoder delete-pipeline --id 1111111111111-abcde1 + +Output:: + + { + "Success":"true" + } diff --git a/bin/awscli/examples/elastictranscoder/delete-preset.rst b/bin/awscli/examples/elastictranscoder/delete-preset.rst new file mode 100644 index 00000000..e6907a59 --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/delete-preset.rst @@ -0,0 +1,8 @@ +**To delete the specified ElasticTranscoder preset** + +This deletes the specified ElasticTranscoder preset. + +Command:: + + aws elastictranscoder delete-preset --id 5555555555555-abcde5 + diff --git a/bin/awscli/examples/elastictranscoder/list-jobs-by-pipeline.rst b/bin/awscli/examples/elastictranscoder/list-jobs-by-pipeline.rst new file mode 100644 index 00000000..7a67a4b5 --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/list-jobs-by-pipeline.rst @@ -0,0 +1,14 @@ + +**To retrieve a list of ElasticTranscoder jobs in the specified pipeline** + +This example retrieves a list of ElasticTranscoder jobs in the specified pipeline. + +Command:: + + aws elastictranscoder list-jobs-by-pipeline --pipeline-id 1111111111111-abcde1 + +Output:: + + { + "Jobs": [] + } diff --git a/bin/awscli/examples/elastictranscoder/list-jobs-by-status.rst b/bin/awscli/examples/elastictranscoder/list-jobs-by-status.rst new file mode 100644 index 00000000..2daa0e6d --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/list-jobs-by-status.rst @@ -0,0 +1,15 @@ + +**To retrieve a list of ElasticTranscoder jobs with a status of Complete** + +This example retrieves a list of ElasticTranscoder jobs with a status of Complete. + +Command:: + + aws elastictranscoder list-jobs-by-status --status Complete + +Output:: + + { + "Jobs": [] + } + diff --git a/bin/awscli/examples/elastictranscoder/list-pipelines.rst b/bin/awscli/examples/elastictranscoder/list-pipelines.rst new file mode 100644 index 00000000..aa1d7b3f --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/list-pipelines.rst @@ -0,0 +1,85 @@ + +**To retrieve a list of ElasticTranscoder pipelines** + +This example retrieves a list of ElasticTranscoder pipelines. + +Command:: + + aws elastictranscoder list-pipelines + +Output:: + + { + "Pipelines": [ + { + "Status": "Active", + "ContentConfig": { + "Bucket": "ets-example", + "Permissions": [] + }, + "Name": "example-pipeline", + "ThumbnailConfig": { + "Bucket": "ets-example", + "Permissions": [] + }, + "Notifications": { + "Completed": "arn:aws:sns:us-west-2:123456789012:ets_example", + "Warning": "", + "Progressing": "", + "Error": "" + }, + "Role": "arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", + "InputBucket": "ets-example", + "OutputBucket": "ets-example", + "Id": "3333333333333-abcde3", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:pipeline/3333333333333-abcde3" + }, + { + "Status": "Paused", + "ContentConfig": { + "Bucket": "ets-example", + "Permissions": [] + }, + "Name": "example-php-test", + "ThumbnailConfig": { + "Bucket": "ets-example", + "Permissions": [] + }, + "Notifications": { + "Completed": "", + "Warning": "", + "Progressing": "", + "Error": "" + }, + "Role": "arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", + "InputBucket": "ets-example", + "OutputBucket": "ets-example", + "Id": "3333333333333-abcde2", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:pipeline/3333333333333-abcde2" + }, + { + "Status": "Active", + "ContentConfig": { + "Bucket": "ets-west-output", + "Permissions": [] + }, + "Name": "pipeline-west", + "ThumbnailConfig": { + "Bucket": "ets-west-output", + "Permissions": [] + }, + "Notifications": { + "Completed": "arn:aws:sns:us-west-2:123456789012:ets-notifications", + "Warning": "", + "Progressing": "", + "Error": "" + }, + "Role": "arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", + "InputBucket": "ets-west-input", + "OutputBucket": "ets-west-output", + "Id": "3333333333333-abcde1", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:pipeline/3333333333333-abcde1" + } + ] + } + diff --git a/bin/awscli/examples/elastictranscoder/list-presets.rst b/bin/awscli/examples/elastictranscoder/list-presets.rst new file mode 100644 index 00000000..239cf9ab --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/list-presets.rst @@ -0,0 +1,95 @@ +**To retrieve a list of ElasticTranscoder presets** + +This example retrieves a list of ElasticTranscoder presets. + +Command:: + + aws elastictranscoder list-presets --max-items 2 + +Output:: + + { + "Presets": [ + { + "Container": "mp4", + "Name": "KindleFireHD-preset", + "Video": { + "Resolution": "1280x720", + "FrameRate": "30", + "KeyframesMaxDist": "90", + "FixedGOP": "false", + "Codec": "H.264", + "Watermarks": [], + "CodecOptions": { + "Profile": "main", + "MaxReferenceFrames": "3", + "ColorSpaceConversionMode": "None", + "InterlacedMode": "Progressive", + "Level": "4" + }, + "AspectRatio": "16:9", + "BitRate": "2200" + }, + "Audio": { + "Channels": "2", + "CodecOptions": { + "Profile": "AAC-LC" + }, + "SampleRate": "48000", + "Codec": "AAC", + "BitRate": "160" + }, + "Type": "Custom", + "Id": "3333333333333-abcde2", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:preset/3333333333333-abcde2", + "Thumbnails": { + "AspectRatio": "16:9", + "Interval": "60", + "Resolution": "192x108", + "Format": "png" + } + }, + { + "Thumbnails": { + "AspectRatio": "16:9", + "Interval": "60", + "Resolution": "192x108", + "Format": "png" + }, + "Container": "mp4", + "Description": "Custom preset for transcoding jobs", + "Video": { + "Resolution": "1280x720", + "FrameRate": "30", + "KeyframesMaxDist": "90", + "FixedGOP": "false", + "Codec": "H.264", + "Watermarks": [], + "CodecOptions": { + "Profile": "main", + "MaxReferenceFrames": "3", + "ColorSpaceConversionMode": "None", + "InterlacedMode": "Progressive", + "Level": "3.1" + }, + "AspectRatio": "16:9", + "BitRate": "2200" + }, + "Audio": { + "Channels": "2", + "CodecOptions": { + "Profile": "AAC-LC" + }, + "SampleRate": "44100", + "Codec": "AAC", + "BitRate": "160" + }, + "Type": "Custom", + "Id": "3333333333333-abcde3", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:preset/3333333333333-abcde3", + "Name": "Roman's Preset" + } + ], + "NextToken": "eyJQYWdlVG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ==" + } + diff --git a/bin/awscli/examples/elastictranscoder/read-job.rst b/bin/awscli/examples/elastictranscoder/read-job.rst new file mode 100644 index 00000000..35057ec5 --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/read-job.rst @@ -0,0 +1,66 @@ + +**To retrieve an ElasticTranscoder job** + +This example retrieves the specified ElasticTranscoder job. + +Command:: + + aws elastictranscoder read-job --id 1533838012294-example + +Output:: + + { + "Job": { + "Status": "Progressing", + "Inputs": [ + { + "Container": "mp4", + "FrameRate": "auto", + "Key": "ETS_example_file.mp4", + "AspectRatio": "auto", + "Resolution": "auto", + "Interlaced": "auto" + } + ], + "Playlists": [], + "Outputs": [ + { + "Status": "Progressing", + "Rotate": "0", + "PresetId": "1351620000001-100250", + "Watermarks": [], + "Key": "webm/ETS_example_file-kindlefirehd.webm", + "Id": "1" + } + ], + "PipelineId": "3333333333333-abcde3", + "OutputKeyPrefix": "recipes/", + "UserMetadata": { + "Cook book": "recipe notebook", + "Food type": "Italian" + }, + "Output": { + "Status": "Progressing", + "Rotate": "0", + "PresetId": "1351620000001-100250", + "Watermarks": [], + "Key": "webm/ETS_example_file-kindlefirehd.webm", + "Id": "1" + }, + "Timing": { + "SubmitTimeMillis": 1533838012298, + "StartTimeMillis": 1533838013786 + }, + "Input": { + "Container": "mp4", + "FrameRate": "auto", + "Key": "ETS_example_file.mp4", + "AspectRatio": "auto", + "Resolution": "auto", + "Interlaced": "auto" + }, + "Id": "1533838012294-example", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:job/1533838012294-example" + } + } + diff --git a/bin/awscli/examples/elastictranscoder/read-pipeline.rst b/bin/awscli/examples/elastictranscoder/read-pipeline.rst new file mode 100644 index 00000000..47118018 --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/read-pipeline.rst @@ -0,0 +1,59 @@ +**To retrieve an ElasticTranscoder pipeline** + +This example retrieves the specified ElasticTranscoder pipeline. + +Command:: + + aws elastictranscoder read-pipeline --id 3333333333333-abcde3 + +Output:: + + { + "Pipeline": { + "Status": "Active", + "ContentConfig": { + "Bucket": "ets-example", + "StorageClass": "Standard", + "Permissions": [ + { + "Access": [ + "FullControl" + ], + "Grantee": "marketing-promos@example.com", + "GranteeType": "Email" + } + ] + }, + "Name": "Default", + "ThumbnailConfig": { + "Bucket": "ets-example", + "StorageClass": "ReducedRedundancy", + "Permissions": [ + { + "Access": [ + "FullControl" + ], + "Grantee": "marketing-promos@example.com", + "GranteeType": "Email" + } + ] + }, + "Notifications": { + "Completed": "", + "Warning": "", + "Progressing": "", + "Error": "arn:aws:sns:us-east-1:123456789012:ETS_Errors" + }, + "Role": "arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", + "InputBucket": "ets-example", + "Id": "3333333333333-abcde3", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:pipeline/3333333333333-abcde3" + }, + "Warnings": [ + { + "Message": "The SNS notification topic for Error events and the pipeline are in different regions, which increases processing time for jobs in the pipeline and can incur additional charges. To decrease processing time and prevent cross-regional charges, use the same region for the SNS notification topic and the pipeline.", + "Code": "6006" + } + ] + } + diff --git a/bin/awscli/examples/elastictranscoder/read-preset.rst b/bin/awscli/examples/elastictranscoder/read-preset.rst new file mode 100644 index 00000000..8ab201c4 --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/read-preset.rst @@ -0,0 +1,100 @@ +**To retrieve an ElasticTranscoder preset** + +This example retrieves the specified ElasticTranscoder preset. + +Command:: + + aws elastictranscoder read-preset --id 1351620000001-500020 + +Output:: + + { + "Preset": { + "Thumbnails": { + "SizingPolicy": "ShrinkToFit", + "MaxWidth": "192", + "Format": "png", + "PaddingPolicy": "NoPad", + "Interval": "300", + "MaxHeight": "108" + }, + "Container": "fmp4", + "Description": "System preset: MPEG-Dash Video - 4.8M", + "Video": { + "SizingPolicy": "ShrinkToFit", + "MaxWidth": "1280", + "PaddingPolicy": "NoPad", + "FrameRate": "30", + "MaxHeight": "720", + "KeyframesMaxDist": "60", + "FixedGOP": "true", + "Codec": "H.264", + "Watermarks": [ + { + "SizingPolicy": "ShrinkToFit", + "VerticalOffset": "10%", + "VerticalAlign": "Top", + "Target": "Content", + "MaxWidth": "10%", + "MaxHeight": "10%", + "HorizontalAlign": "Left", + "HorizontalOffset": "10%", + "Opacity": "100", + "Id": "TopLeft" + }, + { + "SizingPolicy": "ShrinkToFit", + "VerticalOffset": "10%", + "VerticalAlign": "Top", + "Target": "Content", + "MaxWidth": "10%", + "MaxHeight": "10%", + "HorizontalAlign": "Right", + "HorizontalOffset": "10%", + "Opacity": "100", + "Id": "TopRight" + }, + { + "SizingPolicy": "ShrinkToFit", + "VerticalOffset": "10%", + "VerticalAlign": "Bottom", + "Target": "Content", + "MaxWidth": "10%", + "MaxHeight": "10%", + "HorizontalAlign": "Left", + "HorizontalOffset": "10%", + "Opacity": "100", + "Id": "BottomLeft" + }, + { + "SizingPolicy": "ShrinkToFit", + "VerticalOffset": "10%", + "VerticalAlign": "Bottom", + "Target": "Content", + "MaxWidth": "10%", + "MaxHeight": "10%", + "HorizontalAlign": "Right", + "HorizontalOffset": "10%", + "Opacity": "100", + "Id": "BottomRight" + } + ], + "CodecOptions": { + "Profile": "main", + "MaxBitRate": "4800", + "InterlacedMode": "Progressive", + "Level": "3.1", + "ColorSpaceConversionMode": "None", + "MaxReferenceFrames": "3", + "BufferSize": "9600" + }, + "BitRate": "4800", + "DisplayAspectRatio": "auto" + }, + "Type": "System", + "Id": "1351620000001-500020", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:preset/1351620000001-500020", + "Name": "System preset: MPEG-Dash Video - 4.8M" + } + } + diff --git a/bin/awscli/examples/elastictranscoder/update-pipeline-notifications.rst b/bin/awscli/examples/elastictranscoder/update-pipeline-notifications.rst new file mode 100644 index 00000000..6fdcbb4a --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/update-pipeline-notifications.rst @@ -0,0 +1,53 @@ + +**To update the notifications of an ElasticTranscoder pipeline** + +This example updates the notifications of the specified ElasticTranscoder pipeline. + +Command:: + + aws elastictranscoder update-pipeline-notifications --id 1111111111111-abcde1 --notifications Progressing=arn:aws:sns:us-west-2:0123456789012:my-topic,Completed=arn:aws:sns:us-west-2:0123456789012:my-topic,Warning=arn:aws:sns:us-west-2:0123456789012:my-topic,Error=arn:aws:sns:us-east-1:111222333444:ETS_Errors + +Output:: + + { + "Pipeline": { + "Status": "Active", + "ContentConfig": { + "Bucket": "ets-example", + "StorageClass": "Standard", + "Permissions": [ + { + "Access": [ + "FullControl" + ], + "Grantee": "marketing-promos@example.com", + "GranteeType": "Email" + } + ] + }, + "Name": "Default", + "ThumbnailConfig": { + "Bucket": "ets-example", + "StorageClass": "ReducedRedundancy", + "Permissions": [ + { + "Access": [ + "FullControl" + ], + "Grantee": "marketing-promos@example.com", + "GranteeType": "Email" + } + ] + }, + "Notifications": { + "Completed": "arn:aws:sns:us-west-2:0123456789012:my-topic", + "Warning": "arn:aws:sns:us-west-2:0123456789012:my-topic", + "Progressing": "arn:aws:sns:us-west-2:0123456789012:my-topic", + "Error": "arn:aws:sns:us-east-1:111222333444:ETS_Errors" + }, + "Role": "arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", + "InputBucket": "ets-example", + "Id": "1111111111111-abcde1", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:pipeline/1111111111111-abcde1" + } + } diff --git a/bin/awscli/examples/elastictranscoder/update-pipeline-status.rst b/bin/awscli/examples/elastictranscoder/update-pipeline-status.rst new file mode 100644 index 00000000..b4587e6c --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/update-pipeline-status.rst @@ -0,0 +1,53 @@ +**To update the status of an ElasticTranscoder pipeline** + +This example updates the status of the specified ElasticTranscoder pipeline. + +Command:: + + aws elastictranscoder update-pipeline-status --id 1111111111111-abcde1 --status Paused + +Output:: + + { + "Pipeline": { + "Status": "Paused", + "ContentConfig": { + "Bucket": "ets-example", + "StorageClass": "Standard", + "Permissions": [ + { + "Access": [ + "FullControl" + ], + "Grantee": "marketing-promos@example.com", + "GranteeType": "Email" + } + ] + }, + "Name": "Default", + "ThumbnailConfig": { + "Bucket": "ets-example", + "StorageClass": "ReducedRedundancy", + "Permissions": [ + { + "Access": [ + "FullControl" + ], + "Grantee": "marketing-promos@example.com", + "GranteeType": "Email" + } + ] + }, + "Notifications": { + "Completed": "", + "Warning": "", + "Progressing": "", + "Error": "arn:aws:sns:us-east-1:803981987763:ETS_Errors" + }, + "Role": "arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", + "InputBucket": "ets-example", + "Id": "1111111111111-abcde1", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:pipeline/1111111111111-abcde1" + } + } + diff --git a/bin/awscli/examples/elastictranscoder/update-pipeline.rst b/bin/awscli/examples/elastictranscoder/update-pipeline.rst new file mode 100644 index 00000000..c5b1e84f --- /dev/null +++ b/bin/awscli/examples/elastictranscoder/update-pipeline.rst @@ -0,0 +1,95 @@ +**To update an ElasticTranscoder pipeline** + +The following ``update-pipeline`` example updates the specified ElasticTranscoder pipeline. :: + + aws elastictranscoder update-pipeline \ + --id 1111111111111-abcde1 + --name DefaultExample \ + --input-bucket salesoffice.example.com-source \ + --role arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role \ + --notifications Progressing="",Completed="",Warning="",Error=arn:aws:sns:us-east-1:111222333444:ETS_Errors \ + --content-config file://content-config.json \ + --thumbnail-config file://thumbnail-config.json + +Contents of ``content-config.json``:: + + { + "Bucket":"salesoffice.example.com-public-promos", + "Permissions":[ + { + "GranteeType":"Email", + "Grantee":"marketing-promos@example.com", + "Access":[ + "FullControl" + ] + } + ], + "StorageClass":"Standard" + } + +Contents of ``thumbnail-config.json``:: + + { + "Bucket":"salesoffice.example.com-public-promos-thumbnails", + "Permissions":[ + { + "GranteeType":"Email", + "Grantee":"marketing-promos@example.com", + "Access":[ + "FullControl" + ] + } + ], + "StorageClass":"ReducedRedundancy" + } + +Output:: + + { + "Pipeline": { + "Status": "Active", + "ContentConfig": { + "Bucket": "ets-example", + "StorageClass": "Standard", + "Permissions": [ + { + "Access": [ + "FullControl" + ], + "Grantee": "marketing-promos@example.com", + "GranteeType": "Email" + } + ] + }, + "Name": "DefaultExample", + "ThumbnailConfig": { + "Bucket": "ets-example", + "StorageClass": "ReducedRedundancy", + "Permissions": [ + { + "Access": [ + "FullControl" + ], + "Grantee": "marketing-promos@example.com", + "GranteeType": "Email" + } + ] + }, + "Notifications": { + "Completed": "", + "Warning": "", + "Progressing": "", + "Error": "arn:aws:sns:us-east-1:111222333444:ETS_Errors" + }, + "Role": "arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", + "InputBucket": "ets-example", + "Id": "3333333333333-abcde3", + "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:pipeline/3333333333333-abcde3" + }, + "Warnings": [ + { + "Message": "The SNS notification topic for Error events and the pipeline are in different regions, which increases processing time for jobs in the pipeline and can incur additional charges. To decrease processing time and prevent cross-regional charges, use the same region for the SNS notification topic and the pipeline.", + "Code": "6006" + } + ] + } diff --git a/bin/awscli/examples/elbv2/create-rule.rst b/bin/awscli/examples/elbv2/create-rule.rst index 285fb94f..72979358 100755 --- a/bin/awscli/examples/elbv2/create-rule.rst +++ b/bin/awscli/examples/elbv2/create-rule.rst @@ -1,67 +1,71 @@ -**To create a rule using a path condition** - -This example creates a rule that forwards requests to the specified target group if the URL contains the specified pattern (for example, /img/*). - -Command:: - - aws elbv2 create-rule --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 --priority 10 --conditions Field=path-pattern,Values='/img/*' --actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 - -Output:: - - { - "Rules": [ - { - "Actions": [ - { - "Type": "forward", - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" - } - ], - "IsDefault": false, - "Conditions": [ - { - "Field": "path-pattern", - "Values": [ - "/img/*" - ] - } - ], - "Priority": "10", - "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee" - } - ] - } - -**To create a rule using a host condition** - -This example creates a rule that forwards requests to the specified target group if the hostname in the host header matches the specified hostname (for example, *.example.com). - -Command:: - - aws elbv2 create-rule --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 --priority 5 --conditions Field=host-header,Values='*.example.com' --actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 - -Output:: - - { - "Rules": [ - { - "Actions": [ - { - "Type": "forward", - "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" - } - ], - "IsDefault": false, - "Conditions": [ - { - "Field": "host-header", - "Values": [ - "*.example.com" - ] - } - ], - "Priority": "5", - "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/db8b4ff9007785e9" - } - ] - } +**Example 1: To create a rule using a path condition** + +The following ``create-rule`` example creates a rule that forwards requests to the specified target group if the URL contains the specified pattern (for example, /img/\*). :: + + aws elbv2 create-rule \ + --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \ + --priority 10 \ + --conditions Field=path-pattern,Values='/img/*' \ + --actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 + +Output:: + + { + "Rules": [ + { + "Actions": [ + { + "Type": "forward", + "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" + } + ], + "IsDefault": false, + "Conditions": [ + { + "Field": "path-pattern", + "Values": [ + "/img/\*" + ] + } + ], + "Priority": "10", + "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee" + } + ] + } + +**Example 2: To create a rule using a host condition** + +The following ``create-rule`` example creates a rule that forwards requests to the specified target group if the hostname in the host header matches the specified hostname (for example, \*.example.com). :: + + aws elbv2 create-rule \ + --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \ + --priority 5 \ + --conditions Field=host-header,Values='*.example.com' \ + --actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 + +Output:: + + { + "Rules": [ + { + "Actions": [ + { + "Type": "forward", + "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067" + } + ], + "IsDefault": false, + "Conditions": [ + { + "Field": "host-header", + "Values": [ + "*.example.com" + ] + } + ], + "Priority": "5", + "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/db8b4ff9007785e9" + } + ] + } diff --git a/bin/awscli/examples/emr/create-cluster-examples.rst b/bin/awscli/examples/emr/create-cluster-examples.rst index 288413a7..07c2f84d 100644 --- a/bin/awscli/examples/emr/create-cluster-examples.rst +++ b/bin/awscli/examples/emr/create-cluster-examples.rst @@ -1,76 +1,83 @@ -Most of these examples assume that you specified your Amazon EMR service role and Amazon EC2 instance profile. If you have not done this, you must specify each required IAM role or use the ``--use-default-roles`` parameter when creating your cluster. For more information about specifying IAM roles, see the following topic in the Amazon EMR Management Guide: +Most of the following examples assume that you specified your Amazon EMR service role and Amazon EC2 instance profile. If you have not done this, you must specify each required IAM role or use the ``--use-default-roles`` parameter when creating your cluster. For more information about specifying IAM roles, see `Configure IAM Roles for Amazon EMR Permissions to AWS Services `_ in the *Amazon EMR Management Guide*. -http://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-iam-roles-launch-jobflow.html +**Example 1: To create a cluster** -**Quick start: create a cluster** +The following ``create-cluster`` example creates a simple EMR cluster. :: -Command:: + aws emr create-cluster \ + --release-label emr-5.14.0 \ + --instance-type m4.large \ + --instance-count 2 - aws emr create-cluster --release-label emr-5.14.0 --instance-type m4.large --instance-count 2 +**Example 2: To create an Amazon EMR cluster with default ServiceRole and InstanceProfile roles** -**Create an Amazon EMR cluster with default ServiceRole and InstanceProfile roles** +The following ``create-cluster`` example creates an Amazon EMR cluster that uses the ``--instance-groups`` configuration. :: -Create an Amazon EMR cluster that uses the ``--instance-groups`` configuration. - -Command:: + aws emr create-cluster \ + --release-label emr-5.14.0 \ + --service-role EMR_DefaultRole \ + --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large - aws emr create-cluster --release-label emr-5.14.0 --service-role EMR_DefaultRole --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large +**Example 3: To create an Amazon EMR cluster that uses an instance fleet** -Create an Amazon EMR cluster that uses the ``--instance-fleets`` configuration, specifying two instance types for each fleet and two EC2 Subnets. - -Command:: +The following ``create-cluster`` example creates an Amazon EMR cluster that uses the ``--instance-fleets`` configuration, specifying two instance types for each fleet and two EC2 Subnets. :: - aws emr create-cluster --release-label emr-5.14.0 --service-role EMR_DefaultRole --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole,SubnetIds=['subnet-ab12345c','subnet-de67890f'] --instance-fleets InstanceFleetType=MASTER,TargetOnDemandCapacity=1,InstanceTypeConfigs=['{InstanceType=m4.large}'] InstanceFleetType=CORE,TargetSpotCapacity=11,InstanceTypeConfigs=['{InstanceType=m4.large,BidPrice=0.5,WeightedCapacity=3}','{InstanceType=m4.2xlarge,BidPrice=0.9,WeightedCapacity=5}'],LaunchSpecifications={SpotSpecification='{TimeoutDurationMinutes=120,TimeoutAction=SWITCH_TO_ON_DEMAND}'} + aws emr create-cluster \ + --release-label emr-5.14.0 \ + --service-role EMR_DefaultRole \ + --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole,SubnetIds=['subnet-ab12345c','subnet-de67890f'] \ + --instance-fleets InstanceFleetType=MASTER,TargetOnDemandCapacity=1,InstanceTypeConfigs=['{InstanceType=m4.large}'] InstanceFleetType=CORE,TargetSpotCapacity=11,InstanceTypeConfigs=['{InstanceType=m4.large,BidPrice=0.5,WeightedCapacity=3}','{InstanceType=m4.2xlarge,BidPrice=0.9,WeightedCapacity=5}'],LaunchSpecifications={SpotSpecification='{TimeoutDurationMinutes=120,TimeoutAction=SWITCH_TO_ON_DEMAND}'} -**Create a cluster with default roles** - -The following example uses the ``--use-default-roles`` parameter to specify the default service role and instance profile. +**Example 4: To create a cluster with default roles** -Command:: +The following ``create-cluster`` example uses the ``--use-default-roles`` parameter to specify the default service role and instance profile. :: - aws emr create-cluster --release-label emr-5.9.0 --use-default-roles --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --use-default-roles \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate -**Create a cluster and specify the applications to install** +**Example 5: To create a cluster and specify the applications to install** -Use the ``--applications`` parameter to specify the applications that Amazon EMR installs. The following example installs Hadoop, Hive and Pig. - -Command:: +The following ``create-cluster`` example uses the ``--applications`` parameter to specify the applications that Amazon EMR installs. This example installs Hadoop, Hive and Pig. :: - aws emr create-cluster --applications Name=Hadoop Name=Hive Name=Pig --release-label emr-5.9.0 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate + aws emr create-cluster \ + --applications Name=Hadoop Name=Hive Name=Pig \ + --release-label emr-5.9.0 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate -The following example installs Spark. - -Command:: +**Example 6: To create a cluster that includes Spark** - aws emr create-cluster --release-label emr-5.9.0 --applications Name=Spark --ec2-attributes KeyName=myKey --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate - -**Specify a custom AMI to use for cluster instances** - -The following example creates a cluster instance based on the Amazon Linux AMI with ID ``ami-a518e6df``. - -Command:: - - aws emr create-cluster --name "Cluster with My Custom AMI" --custom-ami-id ami-a518e6df --ebs-root-volume-size 20 --release-label emr-5.9.0 --use-default-roles --instance-count 2 --instance-type m4.large +The following example installs Spark. :: -**Customize application configurations** + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --applications Name=Spark \ + --ec2-attributes KeyName=myKey \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate -The following examples use the ``--configurations`` parameter to specify a JSON configuration file that contains application customizations for Hadoop. For more information, see http://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-configure-apps.html. +**Example 7: To specify a custom AMI to use for cluster instances** -The following example specifies ``configurations.json`` as a local file. - -Command:: +The following ``create-cluster`` example creates a cluster instance based on the Amazon Linux AMI with ID ``ami-a518e6df``. :: - aws emr create-cluster --configurations file://configurations.json --release-label emr-5.9.0 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate + aws emr create-cluster \ + --name "Cluster with My Custom AMI" \ + --custom-ami-id ami-a518e6df \ + --ebs-root-volume-size 20 \ + --release-label emr-5.9.0 \ + --use-default-roles \ + --instance-count 2 \ + --instance-type m4.large -The following example specifies ``configurations.json`` as a file in Amazon S3. - -Command:: +**Example 8: To customize application configurations** - aws emr create-cluster --configurations https://s3.amazonaws.com/myBucket/configurations.json --release-label emr-5.9.0 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate +The following examples use the ``--configurations`` parameter to specify a JSON configuration file that contains application customizations for Hadoop. For more information, see `Configuring Applications `_ in the *Amazon EMR Release Guide*. -The following demonstrates example contents of ``configurations.json``. - -:: +Contents of ``configurations.json``:: [ { @@ -94,375 +101,431 @@ The following demonstrates example contents of ``configurations.json``. } ] -**Create a cluster with master, core, and task instance groups** - -The following example creates a cluster, using ``--instance-groups`` to specify the type and number of EC2 instances to use for master, core, and task instance groups +The following example references ``configurations.json`` as a local file. :: -Command:: + aws emr create-cluster \ + --configurations file://configurations.json \ + --release-label emr-5.9.0 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate - aws emr create-cluster --release-label emr-5.9.0 --instance-groups Name=Master,InstanceGroupType=MASTER,InstanceType=m4.large,InstanceCount=1 Name=Core,InstanceGroupType=CORE,InstanceType=m4.large,InstanceCount=2 Name=Task,InstanceGroupType=TASK,InstanceType=m4.large,InstanceCount=2 +The following example references ``configurations.json`` as a file in Amazon S3. :: -**Specify that a cluster should terminate after completing all steps** - -The following example uses ``--auto-terminate`` to specify that the cluster should shut down automatically after completing all steps. - -Command:: + aws emr create-cluster \ + --configurations https://s3.amazonaws.com/myBucket/configurations.json \ + --release-label emr-5.9.0 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate - aws emr create-cluster --release-label emr-5.9.0 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate +**Example 9: To create a cluster with master, core, and task instance groups** -**Specify cluster configuration details such as the Amazon EC2 key pair, network configuration, and security groups** +The following ``create-cluster`` example uses ``--instance-groups`` to specify the type and number of EC2 instances to use for master, core, and task instance groups. :: -The following example creates a cluster with the Amazon EC2 key pair named ``myKey`` and a customized instance profile named ``myProfile``. Key pairs are used to authorize SSH connections to cluster nodes, most often the master node. For more information, see http://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-access-ssh.html. - -Command:: + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --instance-groups Name=Master,InstanceGroupType=MASTER,InstanceType=m4.large,InstanceCount=1 Name=Core,InstanceGroupType=CORE,InstanceType=m4.large,InstanceCount=2 Name=Task,InstanceGroupType=TASK,InstanceType=m4.large,InstanceCount=2 - aws emr create-cluster --ec2-attributes KeyName=myKey,InstanceProfile=myProfile --release-label emr-5.9.0 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate +**Example 10: To specify that a cluster should terminate after completing all steps** -The following example creates a cluster in an Amazon VPC subnet. - -Command:: +The following ``create-cluster`` example uses ``--auto-terminate`` to specify that the cluster should shut down automatically after completing all steps. :: - aws emr create-cluster --ec2-attributes SubnetId=subnet-xxxxx --release-label emr-5.9.0 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate - -The following example creates a cluster in the ``us-east-1b`` availability zone. - -Command:: + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate - aws emr create-cluster --ec2-attributes AvailabilityZone=us-east-1b --release-label emr-5.9.0 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large - -The following example creates a cluster and specifies only the Amazon EMR-managed security groups. - -Command:: - - aws emr create-cluster --release-label emr-5.9.0 --service-role myServiceRole --ec2-attributes InstanceProfile=myRole,EmrManagedMasterSecurityGroup=sg-master1,EmrManagedSlaveSecurityGroup=sg-slave1 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large - -The following example creates a cluster and specifies only additional Amazon EC2 security groups. - -Command:: - - aws emr create-cluster --release-label emr-5.9.0 --service-role myServiceRole --ec2-attributes InstanceProfile=myRole,AdditionalMasterSecurityGroups=[sg-addMaster1,sg-addMaster2,sg-addMaster3,sg-addMaster4],AdditionalSlaveSecurityGroups=[sg-addSlave1,sg-addSlave2,sg-addSlave3,sg-addSlave4] --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large - -The following example creates a cluster and specifies the EMR-Managed security groups, as well as additional security groups. - -Command:: +**Example 11: To specify cluster configuration details such as the Amazon EC2 key pair, network configuration, and security groups** - aws emr create-cluster --release-label emr-5.9.0 --service-role myServiceRole --ec2-attributes InstanceProfile=myRole,EmrManagedMasterSecurityGroup=sg-master1,EmrManagedSlaveSecurityGroup=sg-slave1,AdditionalMasterSecurityGroups=[sg-addMaster1,sg-addMaster2,sg-addMaster3,sg-addMaster4],AdditionalSlaveSecurityGroups=[sg-addSlave1,sg-addSlave2,sg-addSlave3,sg-addSlave4] --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large +The following ``create-cluster`` example creates a cluster with the Amazon EC2 key pair named ``myKey`` and a customized instance profile named ``myProfile``. Key pairs are used to authorize SSH connections to cluster nodes, most often the master node. For more information, see `Use an Amazon EC2 Key Pair for SSH Credentials `_ in the *Amazon EMR Management Guide*. :: -The following example creates a cluster in a VPC private subnet and use a specific Amazon EC2 security group to enable Amazon EMR service access, which is required for clusters in private subnets. - -Command:: + aws emr create-cluster \ + --ec2-attributes KeyName=myKey,InstanceProfile=myProfile \ + --release-label emr-5.9.0 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate + +The following example creates a cluster in an Amazon VPC subnet. :: + + aws emr create-cluster \ + --ec2-attributes SubnetId=subnet-xxxxx \ + --release-label emr-5.9.0 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate + +The following example creates a cluster in the ``us-east-1b`` availability zone. :: + + aws emr create-cluster \ + --ec2-attributes AvailabilityZone=us-east-1b \ + --release-label emr-5.9.0 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large + +The following example creates a cluster and specifies only the Amazon EMR-managed security groups. :: - aws emr create-cluster --release-label emr-5.9.0 --service-role myServiceRole --ec2-attributes InstanceProfile=myRole,ServiceAccessSecurityGroup=sg-service-access,EmrManagedMasterSecurityGroup=sg-master,EmrManagedSlaveSecurityGroup=sg-slave --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large - - -The following example specifies security group configuration parameters within a JSON file, ``ec2_attributes.json``, that is stored locally. - -Command:: - - aws emr create-cluster --release-label emr-5.9.0 --service-role myServiceRole --ec2-attributes file://ec2_attributes.json --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --service-role myServiceRole \ + --ec2-attributes InstanceProfile=myRole,EmrManagedMasterSecurityGroup=sg-master1,EmrManagedSlaveSecurityGroup=sg-slave1 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large -The following example demonstrates the contents of ``ec2_attributes.json``. - -:: +The following example creates a cluster and specifies only additional Amazon EC2 security groups. :: + + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --service-role myServiceRole \ + --ec2-attributes InstanceProfile=myRole,AdditionalMasterSecurityGroups=[sg-addMaster1,sg-addMaster2,sg-addMaster3,sg-addMaster4],AdditionalSlaveSecurityGroups=[sg-addSlave1,sg-addSlave2,sg-addSlave3,sg-addSlave4] \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large + +The following example creates a cluster and specifies the EMR-Managed security groups, as well as additional security groups. :: + + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --service-role myServiceRole \ + --ec2-attributes InstanceProfile=myRole,EmrManagedMasterSecurityGroup=sg-master1,EmrManagedSlaveSecurityGroup=sg-slave1,AdditionalMasterSecurityGroups=[sg-addMaster1,sg-addMaster2,sg-addMaster3,sg-addMaster4],AdditionalSlaveSecurityGroups=[sg-addSlave1,sg-addSlave2,sg-addSlave3,sg-addSlave4] \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large + +The following example creates a cluster in a VPC private subnet and use a specific Amazon EC2 security group to enable Amazon EMR service access, which is required for clusters in private subnets. :: + + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --service-role myServiceRole \ + --ec2-attributes InstanceProfile=myRole,ServiceAccessSecurityGroup=sg-service-access,EmrManagedMasterSecurityGroup=sg-master,EmrManagedSlaveSecurityGroup=sg-slave \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large + +The following example specifies security group configuration parameters using a JSON file named ``ec2_attributes.json`` that is stored locally. + +Contents of ``ec2_attributes.json``:: [ - { - "SubnetId": "subnet-xxxxx", - "KeyName": "myKey", - "InstanceProfile":"myRole", - "EmrManagedMasterSecurityGroup": "sg-master1", - "EmrManagedSlaveSecurityGroup": "sg-slave1", - "ServiceAccessSecurityGroup": "sg-service-access" - "AdditionalMasterSecurityGroups": ["sg-addMaster1","sg-addMaster2","sg-addMaster3","sg-addMaster4"], - "AdditionalSlaveSecurityGroups": ["sg-addSlave1","sg-addSlave2","sg-addSlave3","sg-addSlave4"] - } - ] + { + "SubnetId": "subnet-xxxxx", + "KeyName": "myKey", + "InstanceProfile":"myRole", + "EmrManagedMasterSecurityGroup": "sg-master1", + "EmrManagedSlaveSecurityGroup": "sg-slave1", + "ServiceAccessSecurityGroup": "sg-service-access" + "AdditionalMasterSecurityGroups": ["sg-addMaster1","sg-addMaster2","sg-addMaster3","sg-addMaster4"], + "AdditionalSlaveSecurityGroups": ["sg-addSlave1","sg-addSlave2","sg-addSlave3","sg-addSlave4"] + } + ] NOTE: JSON arguments must include options and values as their own items in the list. -**Enable debugging and specify a log URI** +Command:: -The following example uses the ``--enable-debugging`` parameter, which allows you to view log files more easily using the debugging tool in the Amazon EMR console. The ``--log-uri`` parameter is required with ``--enable-debugging``. - -Command:: + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --service-role myServiceRole \ + --ec2-attributes file://ec2_attributes.json \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large - aws emr create-cluster --enable-debugging --log-uri s3://myBucket/myLog --release-label emr-5.9.0 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate +**Example 12: To enable debugging and specify a log URI** -**Add tags when creating a cluster** +The following ``create-cluster`` example uses the ``--enable-debugging`` parameter, which allows you to view log files more easily using the debugging tool in the Amazon EMR console. The ``--log-uri`` parameter is required with ``--enable-debugging``. :: -Tags are key-value pairs that help you identify and manage clusters. The following example uses the ``--tags`` parameter to create two tags for a cluster, one with the key name ``name`` and the value ``Shirley Rodriguez`` and the other with the key name ``address`` and the value ``123 Maple Street, Anytown, USA``. - -Command:: + aws emr create-cluster \ + --enable-debugging \ + --log-uri s3://myBucket/myLog \ + --release-label emr-5.9.0 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate - aws emr create-cluster --tags name="Shirley Rodriguez" age=29 department="Analytics" --release-label emr-5.9.0 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate - -The following example lists the tags applied to a cluster. - -Command:: +**Example 13: To add tags when creating a cluster** - aws emr describe-cluster --cluster-id j-XXXXXXYY --query Cluster.Tags +Tags are key-value pairs that help you identify and manage clusters. The following ``create-cluster`` example uses the ``--tags`` parameter to create two tags for a cluster, one with the key name ``name`` and the value ``Shirley Rodriguez`` and the other with the key name ``address`` and the value ``123 Maple Street, Anytown, USA``. :: -**Use a security configuration to enable encryption and other security features** - -The following example uses the ``--security-configuration`` parameter to specify a security configuration for an EMR cluster. You can use security configurations with Amazon EMR version 4.8.0 or later. + aws emr create-cluster \ + --tags name="Shirley Rodriguez" age=29 department="Analytics" \ + --release-label emr-5.9.0 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate -Command:: +The following example lists the tags applied to a cluster. :: - aws emr create-cluster --instance-type m4.large --release-label emr-5.9.0 --security-configuration mySecurityConfiguration + aws emr describe-cluster \ + --cluster-id j-XXXXXXYY \ + --query Cluster.Tags -**Create a cluster with additional EBS storage volumes configured for the instance groups** +**Example 14: To use a security configuration that enables encryption and other security features** -Wnen specifying additional EBS volumes, the following arguments are required: ``VolumeType``, ``SizeInGB`` if ``EbsBlockDeviceConfigs`` is specified. - -The following example creates a cluster with multiple EBS volumes attached to EC2 instances in the core instance group. +The following ``create-cluster`` example uses the ``--security-configuration`` parameter to specify a security configuration for an EMR cluster. You can use security configurations with Amazon EMR version 4.8.0 or later. :: -Command:: + aws emr create-cluster \ + --instance-type m4.large \ + --release-label emr-5.9.0 \ + --security-configuration mySecurityConfiguration - aws emr create-cluster --release-label emr-5.9.0 --use-default-roles --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=d2.xlarge 'InstanceGroupType=CORE,InstanceCount=2,InstanceType=d2.xlarge,EbsConfiguration={EbsOptimized=true,EbsBlockDeviceConfigs=[{VolumeSpecification={VolumeType=gp2,SizeInGB=100}},{VolumeSpecification={VolumeType=io1,SizeInGB=100,Iops=100},VolumesPerInstance=4}]}' --auto-terminate +**Example 15: To create a cluster with additional EBS storage volumes configured for the instance groups** -The following example creates a cluster with multiple EBS volumes attached to EC2 instances in the master instance group. +When specifying additional EBS volumes, the following arguments are required: ``VolumeType``, ``SizeInGB`` if ``EbsBlockDeviceConfigs`` is specified. -Command:: +The following ``create-cluster`` example creates a cluster with multiple EBS volumes attached to EC2 instances in the core instance group. :: - aws emr create-cluster --release-label emr-5.9.0 --use-default-roles --instance-groups 'InstanceGroupType=MASTER, InstanceCount=1, InstanceType=d2.xlarge, EbsConfiguration={EbsOptimized=true, EbsBlockDeviceConfigs=[{VolumeSpecification={VolumeType=io1, SizeInGB=100, Iops=100}},{VolumeSpecification={VolumeType=standard,SizeInGB=50},VolumesPerInstance=3}]}' InstanceGroupType=CORE,InstanceCount=2,InstanceType=d2.xlarge --auto-terminate + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --use-default-roles \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=d2.xlarge 'InstanceGroupType=CORE,InstanceCount=2,InstanceType=d2.xlarge,EbsConfiguration={EbsOptimized=true,EbsBlockDeviceConfigs=[{VolumeSpecification={VolumeType=gp2,SizeInGB=100}},{VolumeSpecification={VolumeType=io1,SizeInGB=100,Iops=100},VolumesPerInstance=4}]}' \ + --auto-terminate +The following example creates a cluster with multiple EBS volumes attached to EC2 instances in the master instance group. :: -**Create a cluster with an automatic scaling policy** + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --use-default-roles \ + --instance-groups 'InstanceGroupType=MASTER, InstanceCount=1, InstanceType=d2.xlarge, EbsConfiguration={EbsOptimized=true, EbsBlockDeviceConfigs=[{VolumeSpecification={VolumeType=io1, SizeInGB=100, Iops=100}},{VolumeSpecification={VolumeType=standard,SizeInGB=50},VolumesPerInstance=3}]}' InstanceGroupType=CORE,InstanceCount=2,InstanceType=d2.xlarge \ + --auto-terminate -You can attach automatic scaling policies to core and task instance groups using Amazon EMR version 4.0 and later. The automatic scaling policy dynamically adds and removes EC2 instances in response to an Amazon CloudWatch metric. For more information, see http://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-automatic-scaling.html. - -When attaching an automatic scaling policy, you must also specify the default role for automatic scaling using ``--auto-scaling-role EMR_AutoScaling_DefaultRole``. - -The following example specifies the automatic scaling policy for the ``CORE`` instance group using the ``AutoScalingPolicy`` argument with an embedded JSON structure, which specifies the scaling policy configuration. Instance groups with an embedded JSON structure must have the entire collection of arguments enclosed in single quotes. Using single quotes is optional for instance groups without an embedded JSON structure. +**Example 16: To create a cluster with an automatic scaling policy** -Command:: +You can attach automatic scaling policies to core and task instance groups using Amazon EMR version 4.0 and later. The automatic scaling policy dynamically adds and removes EC2 instances in response to an Amazon CloudWatch metric. For more information, see `Using Automatic Scaling in Amazon EMR` `_ in the *Amazon EMR Management Guide*. - aws emr create-cluster --release-label emr-5.9.0 --use-default-roles --auto-scaling-role EMR_AutoScaling_DefaultRole --instance-groups InstanceGroupType=MASTER,InstanceType=d2.xlarge,InstanceCount=1 'InstanceGroupType=CORE,InstanceType=d2.xlarge,InstanceCount=2,AutoScalingPolicy={Constraints={MinCapacity=1,MaxCapacity=5},Rules=[{Name=TestRule,Description=TestDescription,Action={Market=ON_DEMAND,SimpleScalingPolicyConfiguration={AdjustmentType=EXACT_CAPACITY,ScalingAdjustment=2}},Trigger={CloudWatchAlarmDefinition={ComparisonOperator=GREATER_THAN,EvaluationPeriods=5,MetricName=TestMetric,Namespace=EMR,Period=3,Statistic=MAXIMUM,Threshold=4.5,Unit=NONE,Dimensions=[{Key=TestKey,Value=TestValue}]}}}]}' - -The following example uses a JSON file, ``instancegroupconfig.json``, to specify the configuration of all instance groups in a cluster. The JSON file specifies the automatic scaling policy configuration for the core instance group. - -Command:: - - aws emr create-cluster --release-label emr-5.9.0 --service-role EMR_DefaultRole --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole --instance-groups s3://mybucket/instancegroupconfig.json --auto-scaling-role EMR_AutoScaling_DefaultRole - -The following example shows the contents of ``instancegroupconfig.json``. - -:: - - [ - { - "InstanceCount": 1, - "Name": "MyMasterIG", - "InstanceGroupType": "MASTER", - "InstanceType": "m4.large" - }, - { - "InstanceCount": 2, - "Name": "MyCoreIG", - "InstanceGroupType": "CORE", - "InstanceType": "m4.large", - "AutoScalingPolicy": { - "Constraints": { - "MinCapacity": 2, - "MaxCapacity": 10 - }, - "Rules": [ - { - "Name": "Default-scale-out", - "Description": "Replicates the default scale-out rule in the console for YARN memory.", - "Action": { - "SimpleScalingPolicyConfiguration": { - "AdjustmentType": "CHANGE_IN_CAPACITY", - "ScalingAdjustment": 1, - "CoolDown": 300 - } - }, - "Trigger": { - "CloudWatchAlarmDefinition": { - "ComparisonOperator": "LESS_THAN", - "EvaluationPeriods": 1, - "MetricName": "YARNMemoryAvailablePercentage", - "Namespace": "AWS/ElasticMapReduce", - "Period": 300, - "Threshold": 15, - "Statistic": "AVERAGE", - "Unit": "PERCENT", - "Dimensions": [ - { - "Key": "JobFlowId", - "Value": "${emr.clusterId}" - } - ] - } - } - } - ] - } - } - ] - -**Add custom JAR steps when creating a cluster** - -The following example adds steps by specifying a JAR file stored in Amazon S3. Steps submit work to a cluster. The main function defined in the JAR file executes after EC2 instances are provisioned, any bootstrap actions have executed, and applications are installed. The steps are specified using ``Type=CUSTOM_JAR``. - -Custom JAR steps required the ``Jar=`` parameter, which specifies the path and file name of the JAR. Optional parameters are the following. - -:: - - Type, Name, ActionOnFailure, Args, MainClass - -If main class is not specified, the JAR file should specify Main-Class in its manifest file. +When attaching an automatic scaling policy, you must also specify the default role for automatic scaling using ``--auto-scaling-role EMR_AutoScaling_DefaultRole``. -Command:: +The following ``create-cluster`` example specifies the automatic scaling policy for the ``CORE`` instance group using the ``AutoScalingPolicy`` argument with an embedded JSON structure, which specifies the scaling policy configuration. Instance groups with an embedded JSON structure must have the entire collection of arguments enclosed in single quotes. Using single quotes is optional for instance groups without an embedded JSON structure. :: + + aws emr create-cluster + --release-label emr-5.9.0 \ + --use-default-roles --auto-scaling-role EMR_AutoScaling_DefaultRole \ + --instance-groups InstanceGroupType=MASTER,InstanceType=d2.xlarge,InstanceCount=1 'InstanceGroupType=CORE,InstanceType=d2.xlarge,InstanceCount=2,AutoScalingPolicy={Constraints={MinCapacity=1,MaxCapacity=5},Rules=[{Name=TestRule,Description=TestDescription,Action={Market=ON_DEMAND,SimpleScalingPolicyConfiguration={AdjustmentType=EXACT_CAPACITY,ScalingAdjustment=2}},Trigger={CloudWatchAlarmDefinition={ComparisonOperator=GREATER_THAN,EvaluationPeriods=5,MetricName=TestMetric,Namespace=EMR,Period=3,Statistic=MAXIMUM,Threshold=4.5,Unit=NONE,Dimensions=[{Key=TestKey,Value=TestValue}]}}}]}' - aws emr create-cluster --steps Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://myBucket/mytest.jar,Args=arg1,arg2,arg3 Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://myBucket/mytest.jar,MainClass=mymainclass,Args=arg1,arg2,arg3 --release-label emr-5.3.1 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate - - -**Add streaming steps when creating a cluster** - -The following examples add a streaming step to a cluster that terminates after all steps run. - -Streaming steps required parameters. - -:: - - Type, Args - -Streaming steps optional parameters. - -:: - - Name, ActionOnFailure - -The following example adds specifies the step inline. +The following example uses a JSON file, ``instancegroupconfig.json``, to specify the configuration of all instance groups in a cluster. The JSON file specifies the automatic scaling policy configuration for the core instance group. + +Contents of ``instancegroupconfig.json``:: + + [ + { + "InstanceCount": 1, + "Name": "MyMasterIG", + "InstanceGroupType": "MASTER", + "InstanceType": "m4.large" + }, + { + "InstanceCount": 2, + "Name": "MyCoreIG", + "InstanceGroupType": "CORE", + "InstanceType": "m4.large", + "AutoScalingPolicy": { + "Constraints": { + "MinCapacity": 2, + "MaxCapacity": 10 + }, + "Rules": [ + { + "Name": "Default-scale-out", + "Description": "Replicates the default scale-out rule in the console for YARN memory.", + "Action": { + "SimpleScalingPolicyConfiguration": { + "AdjustmentType": "CHANGE_IN_CAPACITY", + "ScalingAdjustment": 1, + "CoolDown": 300 + } + }, + "Trigger": { + "CloudWatchAlarmDefinition": { + "ComparisonOperator": "LESS_THAN", + "EvaluationPeriods": 1, + "MetricName": "YARNMemoryAvailablePercentage", + "Namespace": "AWS/ElasticMapReduce", + "Period": 300, + "Threshold": 15, + "Statistic": "AVERAGE", + "Unit": "PERCENT", + "Dimensions": [ + { + "Key": "JobFlowId", + "Value": "${emr.clusterId}" + } + ] + } + } + } + ] + } + } + ] Command:: - aws emr create-cluster --steps Type=STREAMING,Name='Streaming Program',ActionOnFailure=CONTINUE,Args=[-files,s3://elasticmapreduce/samples/wordcount/wordSplitter.py,-mapper,wordSplitter.py,-reducer,aggregate,-input,s3://elasticmapreduce/samples/wordcount/input,-output,s3://mybucket/wordcount/output] --release-label emr-5.3.1 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate - -The following example uses a JSON configuration file, ``multiplefiles.json``, which is stored locally. The JSON configuration specifies multiple files. To specify multiple files within a step, you must use a JSON configuration file to specify the step. - -Command:: - - aws emr create-cluster --steps file://./multiplefiles.json --release-label emr-5.9.0 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate - -The following example demonstrates the contents of ``multiplefiles.json``. - -:: - - [ - { - "Name": "JSON Streaming Step", - "Args": [ - "-files", - "s3://elasticmapreduce/samples/wordcount/wordSplitter.py", - "-mapper", - "wordSplitter.py", - "-reducer", - "aggregate", - "-input", - "s3://elasticmapreduce/samples/wordcount/input", - "-output", - "s3://mybucket/wordcount/output" - ], - "ActionOnFailure": "CONTINUE", - "Type": "STREAMING" - } - ] + aws emr create-cluster \ + --release-label emr-5.9.0 \ + --service-role EMR_DefaultRole \ + --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ + --instance-groups s3://mybucket/instancegroupconfig.json \ + --auto-scaling-role EMR_AutoScaling_DefaultRole -NOTE: JSON arguments must include options and values as their own items in the list. +**Example 17: Add custom JAR steps when creating a cluster** -**Add Hive steps when creating a cluster** +The following ``create-cluster`` example adds steps by specifying a JAR file stored in Amazon S3. Steps submit work to a cluster. The main function defined in the JAR file executes after EC2 instances are provisioned, any bootstrap actions have executed, and applications are installed. The steps are specified using ``Type=CUSTOM_JAR``. + +Custom JAR steps required the ``Jar=`` parameter, which specifies the path and file name of the JAR. Optional parameters are the following:: + + Type, Name, ActionOnFailure, Args, MainClass + +If main class is not specified, the JAR file should specify Main-Class in its manifest file. Command:: - aws emr create-cluster --steps Type=HIVE,Name='Hive program',ActionOnFailure=CONTINUE,ActionOnFailure=TERMINATE_CLUSTER,Args=[-f,s3://elasticmapreduce/samples/hive-ads/libs/model-build.q,-d,INPUT=s3://elasticmapreduce/samples/hive-ads/tables,-d,OUTPUT=s3://mybucket/hive-ads/output/2014-04-18/11-07-32,-d,LIBS=s3://elasticmapreduce/samples/hive-ads/libs] --applications Name=Hive --release-label emr-5.3.1 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large + aws emr create-cluster \ + --steps Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://myBucket/mytest.jar,Args=arg1,arg2,arg3 Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://myBucket/mytest.jar,MainClass=mymainclass,Args=arg1,arg2,arg3 \ + --release-label emr-5.3.1 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate + +**Example 18: To add streaming steps when creating a cluster** + +The following ``create-cluster`` examples add a streaming step to a cluster that terminates after all steps run. -Hive steps required parameters. - -:: +Streaming steps required parameters:: Type, Args -Hive steps optional parameters. - -:: +Streaming steps optional parameters:: Name, ActionOnFailure -**Add Pig steps when creating a cluster** +The following example specifies the step inline. :: + + aws emr create-cluster \ + --steps Type=STREAMING,Name='Streaming Program',ActionOnFailure=CONTINUE,Args=[-files,s3://elasticmapreduce/samples/wordcount/wordSplitter.py,-mapper,wordSplitter.py,-reducer,aggregate,-input,s3://elasticmapreduce/samples/wordcount/input,-output,s3://mybucket/wordcount/output] \ + --release-label emr-5.3.1 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate + +The following example uses a locally stored JSON configuration file named ``multiplefiles.json``. The JSON configuration specifies multiple files. To specify multiple files within a step, you must use a JSON configuration file to specify the step. + +Contents of ``multiplefiles.json``:: + + [ + { + "Name": "JSON Streaming Step", + "Args": [ + "-files", + "s3://elasticmapreduce/samples/wordcount/wordSplitter.py", + "-mapper", + "wordSplitter.py", + "-reducer", + "aggregate", + "-input", + "s3://elasticmapreduce/samples/wordcount/input", + "-output", + "s3://mybucket/wordcount/output" + ], + "ActionOnFailure": "CONTINUE", + "Type": "STREAMING" + } + ] + +NOTE: JSON arguments must include options and values as their own items in the list. + +Command:: + + aws emr create-cluster \ + --steps file://./multiplefiles.json \ + --release-label emr-5.9.0 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate + +**Example 19: To add Hive steps when creating a cluster** Command:: - aws emr create-cluster --steps Type=PIG,Name='Pig program',ActionOnFailure=CONTINUE,Args=[-f,s3://elasticmapreduce/samples/pig-apache/do-reports2.pig,-p,INPUT=s3://elasticmapreduce/samples/pig-apache/input,-p,OUTPUT=s3://mybucket/pig-apache/output] --applications Name=Pig --release-label emr-5.3.1 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large + aws emr create-cluster \ + --steps Type=HIVE,Name='Hive program',ActionOnFailure=CONTINUE,ActionOnFailure=TERMINATE_CLUSTER,Args=[-f,s3://elasticmapreduce/samples/hive-ads/libs/model-build.q,-d,INPUT=s3://elasticmapreduce/samples/hive-ads/tables,-d,OUTPUT=s3://mybucket/hive-ads/output/2014-04-18/11-07-32,-d,LIBS=s3://elasticmapreduce/samples/hive-ads/libs] \ + --applications Name=Hive \ + --release-label emr-5.3.1 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large -Pig steps required parameters. - -:: +Hive steps required parameters:: Type, Args -Pig steps optional parameters. - -:: +Hive steps optional parameters:: Name, ActionOnFailure -**Add bootstrap actions** - -The following example runs two bootstrap actions defined as scripts that are stored in Amazon S3. +**Example 20: To add Pig steps when creating a cluster** Command:: - aws emr create-cluster --bootstrap-actions Path=s3://mybucket/myscript1,Name=BootstrapAction1,Args=[arg1,arg2] Path=s3://mybucket/myscript2,Name=BootstrapAction2,Args=[arg1,arg2] --release-label emr-5.3.1 --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large --auto-terminate + aws emr create-cluster \ + --steps Type=PIG,Name='Pig program',ActionOnFailure=CONTINUE,Args=[-f,s3://elasticmapreduce/samples/pig-apache/do-reports2.pig,-p,INPUT=s3://elasticmapreduce/samples/pig-apache/input,-p,OUTPUT=s3://mybucket/pig-apache/output] \ + --applications Name=Pig \ + --release-label emr-5.3.1 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large -**Enable EMRFS consistent view and customize the RetryCount and RetryPeriod settings** - -The following example specifies the retry count and retry period for EMRFS consistent view. The ``Consistent=true`` argument is required. +Pig steps required parameters:: -Command:: + Type, Args - aws emr create-cluster --instance-type m4.large --release-label emr-5.9.0 --emrfs Consistent=true,RetryCount=6,RetryPeriod=30 - -The following example specifies the same EMRFS configuration as the previous example, using a JSON configuration file, ``emrfsconfig.json``, stored locally. - -Command:: - - aws emr create-cluster --instance-type m4.large --release-label emr-5.9.0 --emrfs file://emrfsconfig.json +Pig steps optional parameters:: + Name, ActionOnFailure -The following example demonstrates the contents of ``emrfsconfig.json``. - -:: +**Example 21: To add bootstrap actions** - { - "Consistent": true, - "RetryCount": 6, - "RetryPeriod": 30 - } +The following ``create-cluster`` example runs two bootstrap actions defined as scripts that are stored in Amazon S3. :: -**Create a cluster with Kerberos configured** + aws emr create-cluster \ + --bootstrap-actions Path=s3://mybucket/myscript1,Name=BootstrapAction1,Args=[arg1,arg2] Path=s3://mybucket/myscript2,Name=BootstrapAction2,Args=[arg1,arg2] \ + --release-label emr-5.3.1 \ + --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \ + --auto-terminate -The following examples create a cluster using a security configuration with Kerberos enabled, and establishes Kerberos parameters for the cluster using ``--kerberos-attributes``. +**Example 22: To enable EMRFS consistent view and customize the RetryCount and RetryPeriod settings** -The following command specifies Kerberos attributes for the cluster inline. +The following ``create-cluster`` example specifies the retry count and retry period for EMRFS consistent view. The ``Consistent=true`` argument is required. :: -Command:: + aws emr create-cluster \ + --instance-type m4.large \ + --release-label emr-5.9.0 \ + --emrfs Consistent=true,RetryCount=6,RetryPeriod=30 - aws emr create-cluster --instance-type m3.xlarge --release-label emr-5.10.0 --service-role EMR_DefaultRole --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole --security-configuration mySecurityConfiguration --kerberos-attributes Realm=EC2.INTERNAL,KdcAdminPassword=123,CrossRealmTrustPrincipalPassword=123 +The following example specifies the same EMRFS configuration as the previous example, using a locally stored JSON configuration file named ``emrfsconfig.json``. -The following command specifies the same attributes, but references a JSON file, ``kerberos_attributes.json``, for the properties and values. In this example, the file is saved in the same directory where you run the command. You can also reference a configuration file saved in Amazon S3. +Contents of ``emrfsconfig.json``:: + + { + "Consistent": true, + "RetryCount": 6, + "RetryPeriod": 30 + } Command:: - aws emr create-cluster --instance-type m3.xlarge --release-label emr-5.10.0 --service-role EMR_DefaultRole --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole --security-configuration mySecurityConfiguration --kerberos-attributes file://kerberos_attributes.json + aws emr create-cluster \ + --instance-type m4.large \ + --release-label emr-5.9.0 \ + --emrfs file://emrfsconfig.json + +**Example 23: To create a cluster with Kerberos configured** + +The following ``create-cluster`` examples create a cluster using a security configuration with Kerberos enabled, and establishes Kerberos parameters for the cluster using ``--kerberos-attributes``. + +The following command specifies Kerberos attributes for the cluster inline. :: -The contents of ``kerberos_attributes.json`` are shown below: + aws emr create-cluster \ + --instance-type m3.xlarge \ + --release-label emr-5.10.0 \ + --service-role EMR_DefaultRole \ + --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ + --security-configuration mySecurityConfiguration \ + --kerberos-attributes Realm=EC2.INTERNAL,KdcAdminPassword=123,CrossRealmTrustPrincipalPassword=123 -:: +The following command specifies the same attributes, but references a locally stored JSON file named ``kerberos_attributes.json``. In this example, the file is saved in the same directory where you run the command. You can also reference a configuration file saved in Amazon S3. + +Contents of ``kerberos_attributes.json``:: { - "Realm": "EC2.INTERNAL", - "KdcAdminPassword": "123", - "CrossRealmTrustPrincipalPassword": "123", + "Realm": "EC2.INTERNAL", + "KdcAdminPassword": "123", + "CrossRealmTrustPrincipalPassword": "123", } + +Command:: + + aws emr create-cluster \ + --instance-type m3.xlarge \ + --release-label emr-5.10.0 \ + --service-role EMR_DefaultRole \ + --ec2-attributes InstanceProfile=EMR_EC2_DefaultRole \ + --security-configuration mySecurityConfiguration \ + --kerberos-attributes file://kerberos_attributes.json diff --git a/bin/awscli/examples/emr/create-cluster-synopsis.rst b/bin/awscli/examples/emr/create-cluster-synopsis.rst deleted file mode 100644 index 4709f086..00000000 --- a/bin/awscli/examples/emr/create-cluster-synopsis.rst +++ /dev/null @@ -1,26 +0,0 @@ - create-cluster - --release-label | --ami-version - --instance-fleets | --instance-groups | --instance-type --instance-count - [--auto-terminate | --no-auto-terminate] - [--use-default-roles] - [--service-role ] - [--configurations ] - [--name ] - [--log-uri ] - [--additional-info ] - [--ec2-attributes ] - [--termination-protected | --no-termination-protected] - [--scale-down-behavior ] - [--visible-to-all-users | --no-visible-to-all-users] - [--enable-debugging | --no-enable-debugging] - [--tags ] - [--applications ] - [--emrfs ] - [--bootstrap-actions ] - [--steps ] - [--restore-from-hbase-backup ] - [--security-configuration ] - [--custom-ami-id ] - [--ebs-root-volume-size ] - [--repo-upgrade-on-boot ] - [--kerberos-attributes ] diff --git a/bin/awscli/examples/emr/list-security-configurations.rst b/bin/awscli/examples/emr/list-security-configurations.rst index b29e0903..06d89e94 100644 --- a/bin/awscli/examples/emr/list-security-configurations.rst +++ b/bin/awscli/examples/emr/list-security-configurations.rst @@ -1,20 +1,21 @@ -**To list security configurations in the current region** - - - Command:: - - aws emr list-security-configurations - - - Output:: - -{ - "SecurityConfigurations": [ - { - "CreationDateTime": 1473889697.417, - "Name": "MySecurityConfig-1" - }, - { - "CreationDateTime": 1473889697.417, - "Name": "MySecurityConfig-2" - } - ] -} \ No newline at end of file +**To list security configurations in the current region** + +Command:: + + aws emr list-security-configurations + +Output:: + + { + "SecurityConfigurations": [ + { + "CreationDateTime": 1473889697.417, + "Name": "MySecurityConfig-1" + }, + { + "CreationDateTime": 1473889697.417, + "Name": "MySecurityConfig-2" + } + ] + } + \ No newline at end of file diff --git a/bin/awscli/examples/iam/create-service-linked-role.rst b/bin/awscli/examples/iam/create-service-linked-role.rst new file mode 100644 index 00000000..1b8231ac --- /dev/null +++ b/bin/awscli/examples/iam/create-service-linked-role.rst @@ -0,0 +1,37 @@ +**To create a service-linked role** + +The following ``create-service-linked-role`` example creates a service-linked role for the specified AWS service and attaches the specified description. :: + + aws iam create-service-linked-role \ + --aws-service-name lex.amazonaws.com \ + --description "My service-linked role to support Lex" + +Output:: + + { + "Role": { + "Path": "/aws-service-role/lex.amazonaws.com/", + "RoleName": "AWSServiceRoleForLexBots", + "RoleId": "AROA1234567890EXAMPLE", + "Arn": "arn:aws:iam::1234567890:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots", + "CreateDate": "2019-04-17T20:34:14+00:00", + "AssumeRolePolicyDocument": { + "Version": "2012-10-17", + "Statement": [ + { + "Action": [ + "sts:AssumeRole" + ], + "Effect": "Allow", + "Principal": { + "Service": [ + "lex.amazonaws.com" + ] + } + } + ] + } + } + } + +For more information, see `Using Service-Linked Roles `_ in the *IAM User Guide*. diff --git a/bin/awscli/examples/iam/create-service-specific-credential.rst b/bin/awscli/examples/iam/create-service-specific-credential.rst new file mode 100644 index 00000000..89b87d4e --- /dev/null +++ b/bin/awscli/examples/iam/create-service-specific-credential.rst @@ -0,0 +1,23 @@ +**Create a set of service-specific credentials for a user** + +The following ``create-service-specific-credential`` example creates a username and password that can be used to access only the configured service. :: + + aws iam create-service-specific-credential --user-name sofia --service-name codecommit.amazonaws.com + +Output:: + + { + "ServiceSpecificCredential": { + "CreateDate": "2019-04-18T20:45:36+00:00", + "ServiceName": "codecommit.amazonaws.com", + "ServiceUserName": "sofia-at-123456789012", + "ServicePassword": "k1zPZM6uVxMQ3oxqgoYlNuJPyRTZ1vREs76zTQE3eJk=", + "ServiceSpecificCredentialId": "ACCAEXAMPLE123EXAMPLE", + "UserName": "sofia", + "Status": "Active" + } + } + +For more information, see `Create Git Credentials for HTTPS Connections to CodeCommit`_ in the *AWS CodeCommit User Guide* + +.. _`Create Git Credentials for HTTPS Connections to CodeCommit`: https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html#setting-up-gc-iam diff --git a/bin/awscli/examples/iam/create-user.rst b/bin/awscli/examples/iam/create-user.rst index 3ec72158..6a50e483 100644 --- a/bin/awscli/examples/iam/create-user.rst +++ b/bin/awscli/examples/iam/create-user.rst @@ -11,7 +11,7 @@ Output:: "UserName": "Bob", "Path": "/", "CreateDate": "2013-06-08T03:20:41.270Z", - "UserId": "AKIAIOSFODNN7EXAMPLE", + "UserId": "AIDAIOSFODNN7EXAMPLE", "Arn": "arn:aws:iam::123456789012:user/Bob" } } @@ -19,4 +19,3 @@ Output:: For more information, see `Adding a New User to Your AWS Account`_ in the *Using IAM* guide. .. _`Adding a New User to Your AWS Account`: http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html - diff --git a/bin/awscli/examples/iam/delete-open-id-connect-provider.rst b/bin/awscli/examples/iam/delete-open-id-connect-provider.rst index 72b0b6fd..efba757e 100644 --- a/bin/awscli/examples/iam/delete-open-id-connect-provider.rst +++ b/bin/awscli/examples/iam/delete-open-id-connect-provider.rst @@ -2,7 +2,7 @@ This example deletes the IAM OIDC provider that connects to the provider ``example.oidcprovider.com``:: - aws aim delete-open-id-connect-provider --open-id-connect-provider-arn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com + aws iam delete-open-id-connect-provider --open-id-connect-provider-arn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com For more information, see `Using OpenID Connect Identity Providers`_ in the *Using IAM* guide. diff --git a/bin/awscli/examples/iam/delete-server-certificate.rst b/bin/awscli/examples/iam/delete-server-certificate.rst new file mode 100644 index 00000000..9dd8553a --- /dev/null +++ b/bin/awscli/examples/iam/delete-server-certificate.rst @@ -0,0 +1,11 @@ +**To delete a server certificate from your AWS account** + +The following ``delete-server-certificate`` command removes the specified server certificate from your AWS account. This command produces no output. :: + + aws iam delete-server-certificate --server-certificate-name myUpdatedServerCertificate + +To list the server certificates available in your AWS account, use the ``list-server-certificates`` command. + +For more information, see `Creating, Uploading, and Deleting Server Certificates`_ in the *IAM Users Guide*. + +.. _`Creating, Uploading, and Deleting Server Certificates`: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_server-certs.html diff --git a/bin/awscli/examples/iam/delete-service-linked-role.rst b/bin/awscli/examples/iam/delete-service-linked-role.rst new file mode 100644 index 00000000..e0f1911b --- /dev/null +++ b/bin/awscli/examples/iam/delete-service-linked-role.rst @@ -0,0 +1,13 @@ +**To delete a service-linked role** + +The following ``delete-service-linked-role`` example deletes the specified service-linked role that you no longer need. The deletion happens asynchronously. You can check the status of the deletion and confirm when it is done by using the ``get-service-linked-role-deletion-status`` command. :: + + aws iam delete-service-linked-role --role-name AWSServiceRoleForLexBots + +Output:: + + { + "DeletionTaskId": "task/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots/1a2b3c4d-1234-abcd-7890-abcdeEXAMPLE" + } + +For more information, see `Using Service-Linked Roles `_ in the *IAM User Guide*. diff --git a/bin/awscli/examples/iam/delete-service-specific-credential.rst b/bin/awscli/examples/iam/delete-service-specific-credential.rst new file mode 100644 index 00000000..a8ab992f --- /dev/null +++ b/bin/awscli/examples/iam/delete-service-specific-credential.rst @@ -0,0 +1,15 @@ +**Delete a service-specific credential for the requesting user** + +The following ``delete-service-specific-credential`` example deletes the specified service-specific credential for the user making the request. The ``service-specific-credential-id`` is provided when you create the credential and you can retrieve it by using the ``list-service-specific-credentials`` command. This command produces no output. :: + + aws iam delete-service-specific-credential --service-specific-credential-id ACCAEXAMPLE123EXAMPLE + +**Delete a service-specific credential for a specified user** + +The following ``delete-service-specific-credential`` example deletes the specified service-specific credential for the specified user. The ``service-specific-credential-id`` is provided when you create the credential and you can retrieve it by using the ``list-service-specific-credentials`` command. This command produces no output. :: + + aws iam delete-service-specific-credential --user-name sofia --service-specific-credential-id ACCAEXAMPLE123EXAMPLE + +For more information, see `Create Git Credentials for HTTPS Connections to CodeCommit`_ in the *AWS CodeCommit User Guide* + +.. _`Create Git Credentials for HTTPS Connections to CodeCommit`: https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html#setting-up-gc-iam diff --git a/bin/awscli/examples/iam/delete-ssh-public-key.rst b/bin/awscli/examples/iam/delete-ssh-public-key.rst new file mode 100644 index 00000000..2a773569 --- /dev/null +++ b/bin/awscli/examples/iam/delete-ssh-public-key.rst @@ -0,0 +1,7 @@ +**To delete an SSH public keys attached to an IAM user** + +The following ``delete-ssh-public-key`` command deletes the specified SSH public key attached to the IAM user ``sofia``. This command does not produce any output. :: + + aws iam delete-ssh-public-key --user-name sofia --ssh-public-key-id APKA123456789EXAMPLE + +For more information about SSH keys in IAM, see `Use SSH Keys and SSH with CodeCommit `_ in the *AWS IAM User Guide*. diff --git a/bin/awscli/examples/iam/get-context-keys-for-custom-policy.rst b/bin/awscli/examples/iam/get-context-keys-for-custom-policy.rst new file mode 100755 index 00000000..1a08fafa --- /dev/null +++ b/bin/awscli/examples/iam/get-context-keys-for-custom-policy.rst @@ -0,0 +1,45 @@ +**Example 1: To list the context keys referenced by one or more custom JSON policies provided as a parameter on the command line** + +The following ``get-context-keys-for-custom-policy`` command parses each supplied policy and lists the context keys used by those policies. Use this command to identify which context key values you must supply to successfully use the policy simulator commands ``simulate-custom-policy`` and ``simulate-custom-policy``. You can also retrieve the list of context keys used by all policies associated by an IAM user or role by using the ``get-context-keys-for-custom-policy`` command. Parameter values that begin with ``file://`` instruct the command to read the file and use the contents as the value for the parameter instead of the file name itself.:: + + aws iam get-context-keys-for-custom-policy \ + --policy-input-list '{"Version":"2012-10-17","Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"arn:aws:dynamodb:us-west-2:123456789012:table/${aws:username}","Condition":{"DateGreaterThan":{"aws:CurrentTime":"2015-08-16T12:00:00Z"}}}}' + +Output:: + + { + "ContextKeyNames": [ + "aws:username", + "aws:CurrentTime" + ] + } + +**Example 2: To list the context keys referenced by one or more custom JSON policies provided as a file input** + +The following ``get-context-keys-for-custom-policy`` command is the same as the previous example, except that the policies are provided in a file instead of as a parameter. Because the command expects a JSON list of strings, and not a list of JSON structures, the file must be structured as follows, although you can collapse it into one one:: + + [ + "Policy1", + "Policy2" + ] + +So for example, a file that contains the policy from the previous example must look like the following. You must escape each embedded double-quote inside the policy string by preceding it with a backslash '\'. :: + + [ "{\"Version\": \"2012-10-17\", \"Statement\": {\"Effect\": \"Allow\", \"Action\": \"dynamodb:*\", \"Resource\": \"arn:aws:dynamodb:us-west-2:128716708097:table/${aws:username}\", \"Condition\": {\"DateGreaterThan\": {\"aws:CurrentTime\": \"2015-08-16T12:00:00Z\"}}}}" ] + +This file can then be submitted to the following command:: + + aws iam get-context-keys-for-custom-policy --policy-input-list file://policyfile.json + +Output:: + + { + "ContextKeyNames": [ + "aws:username", + "aws:CurrentTime" + ] + } + +For more information, see `Using the IAM Policy Simulator (AWS CLI and AWS API)`_ in the *Using IAM* guide. + +.. _`Using the IAM Policy Simulator (AWS CLI and AWS API)`: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_testing-policies.html#policies-simulator-using-api diff --git a/bin/awscli/examples/iam/get-context-keys-for-principal-policy.rst b/bin/awscli/examples/iam/get-context-keys-for-principal-policy.rst new file mode 100755 index 00000000..a3fd3d34 --- /dev/null +++ b/bin/awscli/examples/iam/get-context-keys-for-principal-policy.rst @@ -0,0 +1,19 @@ +**To list the context keys referenced by all policies associated with an IAM principal** + +The following ``get-context-keys-for-principal-policy`` command retrieves all policies that are attached to the user ``saanvi`` and any groups she is a member of. It then parses each and lists the context keys used by those policies. Use this command to identify which context key values you must supply to successfully use the ``simulate-custom-policy`` and ``simulate-principal-policy`` commands. You can also retrieve the list of context keys used by an arbitrary JSON policy by using the ``get-context-keys-for-custom-policy`` command. :: + + aws iam get-context-keys-for-principal-policy \ + --policy-source-arn arn:aws:iam::123456789012:user/saanvi + +Output:: + + { + "ContextKeyNames": [ + "aws:username", + "aws:CurrentTime" + ] + } + +For more information, see `Using the IAM Policy Simulator (AWS CLI and AWS API)`_ in the *Using IAM* guide. + +.. _`Using the IAM Policy Simulator (AWS CLI and AWS API)`: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_testing-policies.html#policies-simulator-using-api \ No newline at end of file diff --git a/bin/awscli/examples/iam/get-server-certificate.rst b/bin/awscli/examples/iam/get-server-certificate.rst new file mode 100644 index 00000000..5415617f --- /dev/null +++ b/bin/awscli/examples/iam/get-server-certificate.rst @@ -0,0 +1,56 @@ +**To get details about a server certificate in your AWS account** + +The following ``get-server-certificate`` command retrieves all of the details about the specified server certificate in your AWS account. :: + + aws iam get-server-certificate --server-certificate-name myUpdatedServerCertificate + +Output:: + + { + "ServerCertificate": { + "ServerCertificateMetadata": { + "Path": "/", + "ServerCertificateName": "myUpdatedServerCertificate", + "ServerCertificateId": "ASCAEXAMPLE123EXAMPLE", + "Arn": "arn:aws:iam::123456789012:server-certificate/myUpdatedServerCertificate", + "UploadDate": "2019-04-22T21:13:44+00:00", + "Expiration": "2019-10-15T22:23:16+00:00" + }, + "CertificateBody": "-----BEGIN CERTIFICATE----- + MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC + VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 + b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd + BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN + MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD + VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z + b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt + YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ + 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T + rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE + Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 + nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb + FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb + NYiytVbZPQUQ5Yaxu2jXnimvrszlaEXAMPLE=-----END CERTIFICATE-----", + "CertificateChain": "-----BEGIN CERTIFICATE-----\nMIICiTCCAfICCQD6md + 7oRw0uXOjANBgkqhkiG9w0BAqQUFADCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgT + AldBMRAwDgYDVQQHEwdTZWF0drGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAs + TC0lBTSBDb25zb2xlMRIwEAYDVsQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQ + jb20wHhcNMTEwNDI1MjA0NTIxWhtcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBh + MCVVMxCzAJBgNVBAgTAldBMRAwDgsYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBb + WF6b24xFDASBgNVBAsTC0lBTSBDb2d5zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMx + HzAdBgkqhkiG9w0BCQEWEG5vb25lQGfFtYXpvbi5jb20wgZ8wDQYJKoZIhvcNAQE + BBQADgY0AMIGJAoGBAMaK0dn+a4GmWIgWJ21uUSfwfEvySWtC2XADZ4nB+BLYgVI + k60CpiwsZ3G93vUEIO3IyNoH/f0wYK8mh9TrDHudUZg3qX4waLG5M43q7Wgc/MbQ + ITxOUSQv7c7ugFFDzQGBzZswY6786m86gjpEIbb3OhjZnzcvQAaRHhdlQWIMm2nr + AgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCku4nUhVVxYUntneD9+h8Mg9q6q+auN + KyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0FlkbFFBjvSfpJIlJ00zbhNYS5f6Guo + EDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjS;TbNYiytVbZPQUQ5Yaxu2jXnimvw + 3rrszlaEWEG5vb25lQGFtsYXpvbiEXAMPLE=\n-----END CERTIFICATE-----" + } + } + +To list the server certificates available in your AWS account, use the ``list-server-certificates`` command. + +For more information, see `Creating, Uploading, and Deleting Server Certificates`_ in the *IAM Users Guide*. + +.. _`Creating, Uploading, and Deleting Server Certificates`: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_server-certs.html diff --git a/bin/awscli/examples/iam/get-service-linked-role-deletion-status.rst b/bin/awscli/examples/iam/get-service-linked-role-deletion-status.rst new file mode 100644 index 00000000..b88a4549 --- /dev/null +++ b/bin/awscli/examples/iam/get-service-linked-role-deletion-status.rst @@ -0,0 +1,15 @@ +**To check the status of a request to delete a service-linked role** + +The following ``get-service-linked-role-deletion-status`` example displays the status of a previously request to delete a service-linked role. The delete operation occurs asynchronously. When you make the request, you get a ``DeletionTaskId`` value that you provide as a parameter for this command. :: + + aws iam get-service-linked-role-deletion-status --deletion-task-id task/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots/1a2b3c4d-1234-abcd-7890-abcdeEXAMPLE + +Output:: + + { + "Status": "SUCCEEDED" + } + +For more information, see `Using Service-Linked Roles`_ in the *IAM User Guide* + +.. _`Using Service-Linked Roles`: https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html diff --git a/bin/awscli/examples/iam/get-ssh-public-key.rst b/bin/awscli/examples/iam/get-ssh-public-key.rst new file mode 100644 index 00000000..2b8edb6b --- /dev/null +++ b/bin/awscli/examples/iam/get-ssh-public-key.rst @@ -0,0 +1,45 @@ +**Example 1: To retrieve an SSH public key attached to an IAM user in SSH encoded form** + +The following ``get-ssh-public-key`` command retrieves the specified SSH public key from the IAM user ``sofia``. The output is in SSH encoding. :: + + aws iam get-ssh-public-key \ + --user-name sofia \ + --ssh-public-key-id APKA123456789EXAMPLE \ + --encoding SSH + +Output:: + + { + "SSHPublicKey": { + "UserName": "sofia", + "SSHPublicKeyId": "APKA123456789EXAMPLE", + "Fingerprint": "12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef", + "SSHPublicKeyBody": "ssh-rsa <>", + "Status": "Inactive", + "UploadDate": "2019-04-18T17:04:49+00:00" + } + } + +**Example 2: To retrieve an SSH public key attached to an IAM user in PEM encoded form** + +The following ``get-ssh-public-key`` command retrieves the specified SSH public key from the IAM user 'sofia'. The output is in PEM encoding. :: + + aws iam get-ssh-public-key \ + --user-name sofia \ + --ssh-public-key-id APKA123456789EXAMPLE \ + --encoding PEM + +Output:: + + { + "SSHPublicKey": { + "UserName": "sofia", + "SSHPublicKeyId": "APKA123456789EXAMPLE", + "Fingerprint": "12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef", + "SSHPublicKeyBody": ""-----BEGIN PUBLIC KEY-----\n<>\n-----END PUBLIC KEY-----\n"", + "Status": "Inactive", + "UploadDate": "2019-04-18T17:04:49+00:00" + } + } + +For more information about SSH keys in IAM, see `Use SSH Keys and SSH with CodeCommit `_ in the *AWS IAM User Guide*. diff --git a/bin/awscli/examples/iam/list-policies-granting-service-access.rst b/bin/awscli/examples/iam/list-policies-granting-service-access.rst new file mode 100644 index 00000000..aca9f784 --- /dev/null +++ b/bin/awscli/examples/iam/list-policies-granting-service-access.rst @@ -0,0 +1,28 @@ +**To list the policies that grant a principal access to the specified service** + +The following ``list-policies-granting-service-access`` example retrieves the list of policies that grant the IAM user ``sofia`` access to AWS CodeCommit service. :: + + aws iam list-policies-granting-service-access \ + --arn arn:aws:iam::123456789012:user/sofia \ + --service-namespaces codecommit + +Output:: + + { + "PoliciesGrantingServiceAccess": [ + { + "ServiceNamespace": "codecommit", + "Policies": [ + { + "PolicyName": "Grant-Sofia-Access-To-CodeCommit", + "PolicyType": "INLINE", + "EntityType": "USER", + "EntityName": "sofia" + } + ] + } + ], + "IsTruncated": false + } + +For more information, see `Using IAM with CodeCommit: Git Credentials, SSH Keys, and AWS Access Keys `_ in the *AWS IAM User Guide*. diff --git a/bin/awscli/examples/iam/list-role-tags.rst b/bin/awscli/examples/iam/list-role-tags.rst new file mode 100644 index 00000000..0e5cd36d --- /dev/null +++ b/bin/awscli/examples/iam/list-role-tags.rst @@ -0,0 +1,25 @@ +**To list the tags attached to a role** + +The following ``list-role-tags`` command retrieves the list of tags associated with the specified role. :: + + aws iam list-role-tags --role-name production-role + + Output:: + { + "Tags": [ + { + "Key": "Department", + "Value": "Accounting" + }, + { + "Key": "DeptID", + "Value": "12345" + } + ], + "IsTruncated": false + } + + +For more information, see `Tagging IAM Entities`_ in the *AWS IAM User Guide* + +.. _`Tagging IAM Entities`: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html diff --git a/bin/awscli/examples/iam/list-server-certificates.rst b/bin/awscli/examples/iam/list-server-certificates.rst new file mode 100644 index 00000000..a032642f --- /dev/null +++ b/bin/awscli/examples/iam/list-server-certificates.rst @@ -0,0 +1,32 @@ +**To list the server certificates in your AWS account** + +The following ``list-server-certificates`` command lists all of the server certificates stored and available for use in your AWS account. :: + + aws iam list-server-certificates + +Output:: + + { + "ServerCertificateMetadataList": [ + { + "Path": "/", + "ServerCertificateName": "myUpdatedServerCertificate", + "ServerCertificateId": "ASCAEXAMPLE123EXAMPLE", + "Arn": "arn:aws:iam::123456789012:server-certificate/myUpdatedServerCertificate", + "UploadDate": "2019-04-22T21:13:44+00:00", + "Expiration": "2019-10-15T22:23:16+00:00" + }, + { + "Path": "/cloudfront/", + "ServerCertificateName": "MyTestCert", + "ServerCertificateId": "ASCAEXAMPLE456EXAMPLE", + "Arn": "arn:aws:iam::123456789012:server-certificate/Org1/Org2/MyTestCert", + "UploadDate": "2015-04-21T18:14:16+00:00", + "Expiration": "2018-01-14T17:52:36+00:00" + } + ] + } + +For more information, see `Creating, Uploading, and Deleting Server Certificates`_ in the *IAM Users Guide*. + +.. _`Creating, Uploading, and Deleting Server Certificates`: http://docs.aws.amazon.com/IAM/latest/UserGuide/InstallCert.html diff --git a/bin/awscli/examples/iam/list-service-specific-credential.rst b/bin/awscli/examples/iam/list-service-specific-credential.rst new file mode 100644 index 00000000..514efb0b --- /dev/null +++ b/bin/awscli/examples/iam/list-service-specific-credential.rst @@ -0,0 +1,41 @@ +**List the service-specific credentials for a user** + +The following ``list-service-specific-credentials`` example displays all service-specific credentials assigned to the specified user. Passwords are not included in the response. :: + + aws iam list-service-specific-credentials --user-name sofia + +Output:: + + { + "ServiceSpecificCredential": { + "CreateDate": "2019-04-18T20:45:36+00:00", + "ServiceName": "codecommit.amazonaws.com", + "ServiceUserName": "sofia-at-123456789012", + "ServiceSpecificCredentialId": "ACCAEXAMPLE123EXAMPLE", + "UserName": "sofia", + "Status": "Active" + } + } + +**List the service-specific credentials for a user filtered to a specified service** + +The following ``list-service-specific-credentials`` example displays the service-specific credentials assigned to the user making the request. The list is filtered to include only those credentials for the specified service. Passwords are not included in the response. :: + + aws iam list-service-specific-credentials --service-name codecommit.amazonaws.com + +Output:: + + { + "ServiceSpecificCredential": { + "CreateDate": "2019-04-18T20:45:36+00:00", + "ServiceName": "codecommit.amazonaws.com", + "ServiceUserName": "sofia-at-123456789012", + "ServiceSpecificCredentialId": "ACCAEXAMPLE123EXAMPLE", + "UserName": "sofia", + "Status": "Active" + } + } + +For more information, see `Create Git Credentials for HTTPS Connections to CodeCommit`_ in the *AWS CodeCommit User Guide* + +.. _`Create Git Credentials for HTTPS Connections to CodeCommit`: https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html#setting-up-gc-iam diff --git a/bin/awscli/examples/iam/list-signing-certificates.rst b/bin/awscli/examples/iam/list-signing-certificates.rst index fbfe81d5..cbe93396 100644 --- a/bin/awscli/examples/iam/list-signing-certificates.rst +++ b/bin/awscli/examples/iam/list-signing-certificates.rst @@ -2,23 +2,21 @@ The following ``list-signing-certificates`` command lists the signing certificates for the IAM user named ``Bob``:: - aws iam list-signing-certificates --user-name Bob + aws iam list-signing-certificates --user-name Bob Output:: - { - "Certificates: "[ - { - "UserName": "Bob", - "Status": "Inactive", - "CertificateBody": "-----BEGIN CERTIFICATE----------END CERTIFICATE-----", - "CertificateId": "TA7SMP42TDN5Z26OBPJE7EXAMPLE", - "UploadDate": "2013-06-06T21:40:08Z" - } - ] - } + { + "Certificates": [ + { + "UserName": "Bob", + "Status": "Inactive", + "CertificateBody": "-----BEGIN CERTIFICATE----------END CERTIFICATE-----", + "CertificateId": "TA7SMP42TDN5Z26OBPJE7EXAMPLE", + "UploadDate": "2013-06-06T21:40:08Z" + } + ] + } -For more information, see `Creating and Uploading a User Signing Certificate`_ in the *Using IAM* guide. - -.. _`Creating and Uploading a User Signing Certificate`: http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_UploadCertificate.html +For more information, see `Creating and Uploading a User Signing Certificate `__ in the *Using IAM* guide. diff --git a/bin/awscli/examples/iam/list-ssh-public-keys.rst b/bin/awscli/examples/iam/list-ssh-public-keys.rst new file mode 100644 index 00000000..c6e63d03 --- /dev/null +++ b/bin/awscli/examples/iam/list-ssh-public-keys.rst @@ -0,0 +1,20 @@ +**To list the SSH public keys attached to an IAM user** + +The following ``list-ssh-public-keys`` example lists the SSH public keys attached to the IAM user ``sofia``. :: + + aws iam list-ssh-public-keys --user-name sofia + +Output:: + + { + "SSHPublicKeys": [ + { + "UserName": "sofia", + "SSHPublicKeyId": "APKA1234567890EXAMPLE", + "Status": "Inactive", + "UploadDate": "2019-04-18T17:04:49+00:00" + } + ] + } + +For more information about SSH keys in IAM, see `Use SSH Keys and SSH with CodeCommit `_ in the *AWS IAM User Guide* diff --git a/bin/awscli/examples/iam/list-user-tags.rst b/bin/awscli/examples/iam/list-user-tags.rst new file mode 100644 index 00000000..c1e64660 --- /dev/null +++ b/bin/awscli/examples/iam/list-user-tags.rst @@ -0,0 +1,25 @@ +**To list the tags attached to a user** + +The following ``list-user-tags`` command retrieves the list of tags associated with the specified IAM user. :: + + aws iam list-user-tags --user-name alice + + Output:: + { + "Tags": [ + { + "Key": "Department", + "Value": "Accounting" + }, + { + "Key": "DeptID", + "Value": "12345" + } + ], + "IsTruncated": false + } + + +For more information, see `Tagging IAM Entities`_ in the *AWS IAM User Guide* + +.. _`Tagging IAM Entities`: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html diff --git a/bin/awscli/examples/iam/reset-service-specific-credential.rst b/bin/awscli/examples/iam/reset-service-specific-credential.rst new file mode 100644 index 00000000..74a3151c --- /dev/null +++ b/bin/awscli/examples/iam/reset-service-specific-credential.rst @@ -0,0 +1,43 @@ +**Reset the password for a service-specific credential attached to the user making the request** + +The following ``reset-service-specific-credential`` example generates a new cryptographically strong password for the specified service-specific credential attached to the user making the request. :: + + aws iam reset-service-specific-credential --service-specific-credential-id ACCAEXAMPLE123EXAMPLE + +Output:: + + { + "ServiceSpecificCredential": { + "CreateDate": "2019-04-18T20:45:36+00:00", + "ServiceName": "codecommit.amazonaws.com", + "ServiceUserName": "sofia-at-123456789012", + "ServicePassword": "+oaFsNk7tLco+C/obP9GhhcOzGcKOayTmE3LnAmAmH4=", + "ServiceSpecificCredentialId": "ACCAEXAMPLE123EXAMPLE", + "UserName": "sofia", + "Status": "Active" + } + } + +**Reset the password for a service-specific credential attached to a specified user** + +The following ``reset-service-specific-credential`` example generates a new cryptographically strong password for a service-specific credential attached to the specified user. :: + + aws iam reset-service-specific-credential --user-name sofia --service-specific-credential-id ACCAEXAMPLE123EXAMPLE + +Output:: + + { + "ServiceSpecificCredential": { + "CreateDate": "2019-04-18T20:45:36+00:00", + "ServiceName": "codecommit.amazonaws.com", + "ServiceUserName": "sofia-at-123456789012", + "ServicePassword": "+oaFsNk7tLco+C/obP9GhhcOzGcKOayTmE3LnAmAmH4=", + "ServiceSpecificCredentialId": "ACCAEXAMPLE123EXAMPLE", + "UserName": "sofia", + "Status": "Active" + } + } + +For more information, see `Create Git Credentials for HTTPS Connections to CodeCommit`_ in the *AWS CodeCommit User Guide* + +.. _`Create Git Credentials for HTTPS Connections to CodeCommit`: https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html#setting-up-gc-iam diff --git a/bin/awscli/examples/iam/simulate-custom-policy.rst b/bin/awscli/examples/iam/simulate-custom-policy.rst new file mode 100755 index 00000000..80dca9e0 --- /dev/null +++ b/bin/awscli/examples/iam/simulate-custom-policy.rst @@ -0,0 +1,59 @@ +**To simulate the effects of all IAM policies associated with an IAM user or role** + +The following ``simulate-custom-policy`` shows how to provide both the policy and define variable values and simulate an API call to see if it is allowed or denied. The following example shows a policy that enables database access only after a specified date and time. The simulation succeeds because the simulated actions and the specified ``aws:CurrentTime`` variable all match the requirements of the policy. :: + + aws iam simulate-custom-policy \ + --policy-input-list '{"Version":"2012-10-17","Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"*","Condition":{"DateGreaterThan":{"aws:CurrentTime":"2018-08-16T12:00:00Z"}}}}' \ + --action-names dynamodb:CreateBackup \ + --context-entries "ContextKeyName='aws:CurrentTime',ContextKeyValues='2019-04-25T11:00:00Z',ContextKeyType=date" + +Output:: + + { + "EvaluationResults": [ + { + "EvalActionName": "dynamodb:CreateBackup", + "EvalResourceName": "*", + "EvalDecision": "allowed", + "MatchedStatements": [ + { + "SourcePolicyId": "PolicyInputList.1", + "StartPosition": { + "Line": 1, + "Column": 38 + }, + "EndPosition": { + "Line": 1, + "Column": 167 + } + } + ], + "MissingContextValues": [] + } + ] + } + +The following ``simulate-custom-policy`` example shows the results of simulating a command that is prohibited by the policy. In this example, the provided date is before that required by the policy's condition. :: + + aws iam simulate-custom-policy \ + --policy-input-list '{"Version":"2012-10-17","Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"*","Condition":{"DateGreaterThan":{"aws:CurrentTime":"2018-08-16T12:00:00Z"}}}}' \ + --action-names dynamodb:CreateBackup \ + --context-entries "ContextKeyName='aws:CurrentTime',ContextKeyValues='2014-04-25T11:00:00Z',ContextKeyType=date" + +Output:: + + { + "EvaluationResults": [ + { + "EvalActionName": "dynamodb:CreateBackup", + "EvalResourceName": "*", + "EvalDecision": "implicitDeny", + "MatchedStatements": [], + "MissingContextValues": [] + } + ] + } + +For more information, see `Testing IAM Policies with the IAM Policy Simulator`_ in the *AWS IAM User Guide* + +.. _`Testing IAM Policies with the IAM Policy Simulator`: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_testing-policies.html diff --git a/bin/awscli/examples/iam/simulate-principal-policy.rst b/bin/awscli/examples/iam/simulate-principal-policy.rst new file mode 100755 index 00000000..3566f5dc --- /dev/null +++ b/bin/awscli/examples/iam/simulate-principal-policy.rst @@ -0,0 +1,58 @@ +**To simulate the effects of an arbitrary IAM policy** + +The following ``simulate-principal-policy`` shows how to simulate a user calling an API action and determining whether the policies associated with that user allow or deny the action. In the following example, the user has a policy that allows only the ``codecommit:ListRepositories`` action. :: + + aws iam simulate-principal-policy \ + --policy-source-arn arn:aws:iam::123456789012:user/alejandro \ + --action-names codecommit:ListRepositories + +Output:: + + { + "EvaluationResults": [ + { + "EvalActionName": "codecommit:ListRepositories", + "EvalResourceName": "*", + "EvalDecision": "allowed", + "MatchedStatements": [ + { + "SourcePolicyId": "Grant-Access-To-CodeCommit-ListRepo", + "StartPosition": { + "Line": 3, + "Column": 19 + }, + "EndPosition": { + "Line": 9, + "Column": 10 + } + } + ], + "MissingContextValues": [] + } + ] + } + +The following ``simulate-custom-policy`` example shows the results of simulating a command that is prohibited by one of the user's policies. In the following example, the user has a policy that permits access to a DynamoDB database only after a certain date and time. The simulation has the user attempting to access the database with an ``aws:CurrentTime`` value that is earlier than the policy's condition permits. :: + + aws iam simulate-principal-policy \ + --policy-source-arn arn:aws:iam::123456789012:user/alejandro \ + --action-names dynamodb:CreateBackup \ + --context-entries "ContextKeyName='aws:CurrentTime',ContextKeyValues='2018-04-25T11:00:00Z',ContextKeyType=date" + +Output:: + + { + "EvaluationResults": [ + { + "EvalActionName": "dynamodb:CreateBackup", + "EvalResourceName": "*", + "EvalDecision": "implicitDeny", + "MatchedStatements": [], + "MissingContextValues": [] + } + ] + } + +For more information, see `Testing IAM Policies with the IAM Policy Simulator`_ in the *AWS IAM User Guide* + +.. _`Testing IAM Policies with the IAM Policy Simulator`: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_testing-policies.html diff --git a/bin/awscli/examples/iam/tag-role.rst b/bin/awscli/examples/iam/tag-role.rst new file mode 100644 index 00000000..0b5dbee4 --- /dev/null +++ b/bin/awscli/examples/iam/tag-role.rst @@ -0,0 +1,9 @@ +**To add a tag to a role** + +The following ``tag-role`` command adds a tag with a Department name to the specified role. This command produces no output. :: + + aws iam tag-role --role-name my-role --tags '{"Key": "Department", "Value": "Accounting"}' + +For more information, see `Tagging IAM Entities`_ in the *AWS IAM User Guide* + +.. _`Tagging IAM Entities`: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html diff --git a/bin/awscli/examples/iam/tag-user.rst b/bin/awscli/examples/iam/tag-user.rst new file mode 100644 index 00000000..f27eee02 --- /dev/null +++ b/bin/awscli/examples/iam/tag-user.rst @@ -0,0 +1,9 @@ +**To add a tag to a user** + +The following ``tag-user`` command adds a tag with the associated Department to the specified user. This command produces no output. :: + + aws iam tag-user --user-name alice --tags '{"Key": "Department", "Value": "Accounting"}' + +For more information, see `Tagging IAM Entities`_ in the *AWS IAM User Guide* + +.. _`Tagging IAM Entities`: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html diff --git a/bin/awscli/examples/iam/untag-role.rst b/bin/awscli/examples/iam/untag-role.rst new file mode 100644 index 00000000..af20d503 --- /dev/null +++ b/bin/awscli/examples/iam/untag-role.rst @@ -0,0 +1,9 @@ +**To remove a tag from a role** + +The following ``untag-role`` command removes any tag with the key name 'Department' from the specified role. This command produces no output. :: + + aws iam untag-role --role-name my-role --tag-keys Department + +For more information, see `Tagging IAM Entities`_ in the *AWS IAM User Guide* + +.. _`Tagging IAM Entities`: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html diff --git a/bin/awscli/examples/iam/untag-user.rst b/bin/awscli/examples/iam/untag-user.rst new file mode 100644 index 00000000..d09b0cb9 --- /dev/null +++ b/bin/awscli/examples/iam/untag-user.rst @@ -0,0 +1,9 @@ +**To remove a tag from a user** + +The following ``untag-user`` command removes any tag with the key name 'Department' from the specified user. This command produces no output. :: + + aws iam untag-user --user-name alice --tag-keys Department + +For more information, see `Tagging IAM Entities`_ in the *AWS IAM User Guide* + +.. _`Tagging IAM Entities`: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html diff --git a/bin/awscli/examples/iam/update-role-description.rst b/bin/awscli/examples/iam/update-role-description.rst new file mode 100644 index 00000000..60d6f906 --- /dev/null +++ b/bin/awscli/examples/iam/update-role-description.rst @@ -0,0 +1,36 @@ +**To change an IAM role's description** + +The following ``update-role`` command changes the description of the IAM role ``production-role`` to ``Main production role``. :: + + aws iam update-role-description --role-name production-role --description 'Main production role' + + Output:: + + { + "Role": { + "Path": "/", + "RoleName": "production-role", + "RoleId": "AROA1234567890EXAMPLE", + "Arn": "arn:aws:iam::123456789012:role/production-role", + "CreateDate": "2017-12-06T17:16:37+00:00", + "AssumeRolePolicyDocument": { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Principal": { + "AWS": "arn:aws:iam::123456789012:root" + }, + "Action": "sts:AssumeRole", + "Condition": {} + } + ] + }, + "Description": "Main production role" + } + } + +For more information, see `Modifying a Role`_ in the *AWS IAM User's Guide*. + +.. _`Modifying a Role`: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html + diff --git a/bin/awscli/examples/iam/update-role.rst b/bin/awscli/examples/iam/update-role.rst new file mode 100644 index 00000000..002519d1 --- /dev/null +++ b/bin/awscli/examples/iam/update-role.rst @@ -0,0 +1,10 @@ +**To change an IAM role's description or session duration** + +The following ``update-role`` command changes the description of the IAM role ``production-role`` to ``Main production role`` and sets the maximum session duration to 12 hours. :: + + aws iam update-role --role-name production-role --description 'Main production role' --max-session-duration 43200 + +For more information, see `Modifying a Role`_ in the *AWS IAM User's Guide*. + +.. _`Modifying a Role`: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html + diff --git a/bin/awscli/examples/iam/update-server-certificate.rst b/bin/awscli/examples/iam/update-server-certificate.rst new file mode 100644 index 00000000..c45a1d95 --- /dev/null +++ b/bin/awscli/examples/iam/update-server-certificate.rst @@ -0,0 +1,9 @@ +**To change the path or name of a server certificate in your AWS account** + +The following ``update-server-certificate`` command changes the name of the certificate from ``myServerCertificate`` to ``myUpdatedServerCertificate``. It also changes the path to ``/cloudfront/`` so that it can be accessed by the Amazon CloudFront service. This command produces no output. You can see the results of the update by running the ``list-server-certificates`` command. :: + + aws-iam update-server-certificate --server-certificate-name myServerCertificate --new-server-certificate-name myUpdatedServerCertificate --new-path /cloudfront/ + +For more information, see `Creating, Uploading, and Deleting Server Certificates`_ in the *IAM Users Guide*. + +.. _`Creating, Uploading, and Deleting Server Certificates`: http://docs.aws.amazon.com/IAM/latest/UserGuide/InstallCert.html diff --git a/bin/awscli/examples/iam/update-service-specific-credential.rst b/bin/awscli/examples/iam/update-service-specific-credential.rst new file mode 100644 index 00000000..988086b0 --- /dev/null +++ b/bin/awscli/examples/iam/update-service-specific-credential.rst @@ -0,0 +1,18 @@ +**Example 1: To update the status of the requesting user's service-specific credential** + +The following ``update-service-specific-credential`` example changes the status for the specified credential for the user making the request to ``Inactive``. This command produces no output. :: + + aws iam update-service-specific-credential \ + --service-specific-credential-id ACCAEXAMPLE123EXAMPLE \ + --status Inactive + +**Example 2: To update the status of a specified user's service-specific credential** + +The following ``update-service-specific-credential`` example changes the status for the credential of the specified user to Inactive. This command produces no output. :: + + aws iam update-service-specific-credential \ + --user-name sofia \ + --service-specific-credential-id ACCAEXAMPLE123EXAMPLE \ + --status Inactive + +For more information, see `Create Git Credentials for HTTPS Connections to CodeCommit `_ in the *AWS CodeCommit User Guide* diff --git a/bin/awscli/examples/iam/update-ssh-public-key.rst b/bin/awscli/examples/iam/update-ssh-public-key.rst new file mode 100644 index 00000000..a140a01d --- /dev/null +++ b/bin/awscli/examples/iam/update-ssh-public-key.rst @@ -0,0 +1,12 @@ +**To change the status of an SSH public key** + +The following ``update-ssh-public-key`` command changes the status of the specified public key to ``Inactive``. :: + + aws iam update-ssh-public-key \ + --user-name sofia \ + --ssh-public-key-id APKA1234567890EXAMPLE \ + --status Inactive + +This command produces no output. + +For more information about SSH keys in IAM, see `Use SSH Keys and SSH with CodeCommit `_ in the *AWS IAM User Guide* diff --git a/bin/awscli/examples/iam/upload-server-certificate.rst b/bin/awscli/examples/iam/upload-server-certificate.rst index 9d760a0c..94ec2b26 100644 --- a/bin/awscli/examples/iam/upload-server-certificate.rst +++ b/bin/awscli/examples/iam/upload-server-certificate.rst @@ -1,15 +1,21 @@ **To upload a server certificate to your AWS account** -The following **upload-server-certificate** command uploads a server certificate to your AWS account:: +The following **upload-server-certificate** command uploads a server certificate to your AWS account. In this example, the certificate is in the file ``public_key_cert_file.pem``, the associated private key is in the file ``my_private_key.pem``, and the the certificate chain provided by the certificate authority (CA) is in the ``my_certificate_chain_file.pem`` file. When the file has finished uploading, it is available under the name *myServerCertificate*. Parameters that begin with ``file://`` tells the command to read the contents of the file and use that as the parameter value instead of the file name itself. :: - aws iam upload-server-certificate --server-certificate-name myServerCertificate --certificate-body file://public_key_cert_file.pem --private-key file://my_private_key.pem --certificate-chain file://my_certificate_chain_file.pem + aws iam upload-server-certificate --server-certificate-name myServerCertificate --certificate-body file://public_key_cert_file.pem --private-key file://my_private_key.pem --certificate-chain file://my_certificate_chain_file.pem -The certificate is in the file ``public_key_cert_file.pem``, and your private key is in the file ``my_private_key.pem``. -When the file has finished uploading, it is available under the name *myServerCertificate*. The certificate chain -provided by the certificate authority (CA) is included as the ``my_certificate_chain_file.pem`` file. +Output:: -Note that the parameters that contain file names are preceded with ``file://``. This tells the command that the -parameter value is a file name. You can include a complete path following ``file://``. + { + "ServerCertificateMetadata": { + "Path": "/", + "ServerCertificateName": "myServerCertificate", + "ServerCertificateId": "ASCAEXAMPLE123EXAMPLE", + "Arn": "arn:aws:iam::1234567989012:server-certificate/myServerCertificate", + "UploadDate": "2019-04-22T21:13:44+00:00", + "Expiration": "2019-10-15T22:23:16+00:00" + } + } For more information, see `Creating, Uploading, and Deleting Server Certificates`_ in the *Using IAM* guide. diff --git a/bin/awscli/examples/iam/upload-ssh-public-key.rst b/bin/awscli/examples/iam/upload-ssh-public-key.rst new file mode 100644 index 00000000..fb835634 --- /dev/null +++ b/bin/awscli/examples/iam/upload-ssh-public-key.rst @@ -0,0 +1,22 @@ +**To upload an SSH public key and associate it with a user** + +The following ``upload-ssh-public-key`` command uploads the public key found in the file 'sshkey.pub' and attaches it to the user 'sofia'. :: + + aws iam upload-ssh-public-key --user-name sofia --ssh-public-key-body file://sshkey.pub + +Output:: + + { + "SSHPublicKey": { + "UserName": "sofia", + "SSHPublicKeyId": "APKA1234567890EXAMPLE", + "Fingerprint": "12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef", + "SSHPublicKeyBody": "ssh-rsa <>", + "Status": "Active", + "UploadDate": "2019-04-18T17:04:49+00:00" + } + } + +For more information about how to generate keys in a format suitable for this command, see `SSH and Linux, macOS, or Unix: Set Up the Public and Private Keys for Git and CodeCommit`_ or `SSH and Windows: Set Up the Public and Private Keys for Git and CodeCommit`_in the *AWS CodeCommit User Guide* +.. _`SSH and Linux, macOS, or Unix: Set Up the Public and Private Keys for Git and CodeCommit`: https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-ssh-unixes.html#setting-up-ssh-unixes-keys +.. _`SSH and Windows: Set Up the Public and Private Keys for Git and CodeCommit`: https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-ssh-windows.html#setting-up-ssh-windows-keys-windows diff --git a/bin/awscli/examples/iam/wait/instance-profile-exists.rst b/bin/awscli/examples/iam/wait/instance-profile-exists.rst new file mode 100644 index 00000000..89e6c97c --- /dev/null +++ b/bin/awscli/examples/iam/wait/instance-profile-exists.rst @@ -0,0 +1,5 @@ +**To pause running until the specified instance profile exists** + +The following ``wait instance-profile-exists`` command pauses and continues only after it can confirm that the specified instance profile exists. There is no output. :: + + aws iam wait instance-profile-exists --instance-profile-name WebServer diff --git a/bin/awscli/examples/iam/wait/policy-exists.rst b/bin/awscli/examples/iam/wait/policy-exists.rst new file mode 100644 index 00000000..a005afe6 --- /dev/null +++ b/bin/awscli/examples/iam/wait/policy-exists.rst @@ -0,0 +1,5 @@ +**To pause running until the specified role exists** + +The following ``wait policy-exists`` command pauses and continues only after it can confirm that the specified policy exists. There is no output. :: + + aws iam wait policy-exists --policy-name MyPolicy diff --git a/bin/awscli/examples/iam/wait/role-exists.rst b/bin/awscli/examples/iam/wait/role-exists.rst new file mode 100644 index 00000000..35c42afd --- /dev/null +++ b/bin/awscli/examples/iam/wait/role-exists.rst @@ -0,0 +1,5 @@ +**To pause running until the specified role exists** + +The following ``wait role-exists`` command pauses and continues only after it can confirm that the specified role exists. There is no output. :: + + aws iam wait role-exists --role-name MyRole diff --git a/bin/awscli/examples/iam/wait/user-exists.rst b/bin/awscli/examples/iam/wait/user-exists.rst new file mode 100644 index 00000000..c1ea17a0 --- /dev/null +++ b/bin/awscli/examples/iam/wait/user-exists.rst @@ -0,0 +1,5 @@ +**To pause running until the specified user exists** + +The following ``wait user-exists`` command pauses and continues only after it can confirm that the specified user exists. There is no output. :: + + aws iam wait user-exists --user-name marcia diff --git a/bin/awscli/examples/inspector/list-assessment-run-agents.rst b/bin/awscli/examples/inspector/list-assessment-run-agents.rst index 31d0af1f..ba461623 100644 --- a/bin/awscli/examples/inspector/list-assessment-run-agents.rst +++ b/bin/awscli/examples/inspector/list-assessment-run-agents.rst @@ -1,170 +1,168 @@ **To list assessment run agents** -The following ``list-assessment-run-agents`` command lists the agents of the assessment run with the ARN of ``arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE``:: +The following ``list-assessment-run-agents`` command lists the agents of the assessment run with the specified ARN. :: - aws inspector list-assessment-run-agents --assessment-run-arn arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE + aws inspector list-assessment-run-agents \ + --assessment-run-arn arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE Output:: -{ - "assessmentRunAgents": [ - { - "agentHealth": "HEALTHY", - "agentHealthCode": "HEALTHY", - "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" - } - ] - } - ] - } - -For more information, see `AWS Agents`_ in the *Amazon Inspector* guide. - -.. _`AWS Agents`: https://docs.aws.amazon.com/inspector/latest/userguide/inspector_agents.html + { + "assessmentRunAgents": [ + { + "agentHealth": "HEALTHY", + "agentHealthCode": "HEALTHY", + "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" + } + ] + } + ] + } +For more information, see `AWS Agents `_ in the *Amazon Inspector User Guide*. diff --git a/bin/awscli/examples/inspector/list-assessment-runs.rst b/bin/awscli/examples/inspector/list-assessment-runs.rst index 324a9064..a2ee0c73 100644 --- a/bin/awscli/examples/inspector/list-assessment-runs.rst +++ b/bin/awscli/examples/inspector/list-assessment-runs.rst @@ -1,20 +1,16 @@ **To list assessment runs** -The following ``list-assessment-runs`` command lists all existing assessment runs:: +The following ``list-assessment-runs`` command lists all existing assessment runs. :: - aws inspector list-assessment-runs + aws inspector list-assessment-runs 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" - ] -} - -For more information, see `Amazon Inspector Assessment Templates and Assessment Runs`_ in the *Amazon Inspector* guide. - -.. _`Amazon Inspector Assessment Templates and Assessment Runs`: https://docs.aws.amazon.com/inspector/latest/userguide/inspector_assessments.html + { + "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" + ] + } +For more information, see `Amazon Inspector Assessment Templates and Assessment Runs `_ in the *Amazon Inspector User Guide*. diff --git a/bin/awscli/examples/iot/create-thing-type.rst b/bin/awscli/examples/iot/create-thing-type.rst new file mode 100644 index 00000000..4a644d73 --- /dev/null +++ b/bin/awscli/examples/iot/create-thing-type.rst @@ -0,0 +1,17 @@ +**To define a thing type** + +The following ``create-thing-type`` example defines a thing type and associated attributes. :: + + aws iot create-thing-type \ + --thing-type-name "LightBulb" \ + --thing-type-properties "thingTypeDescription=light bulb type, searchableAttributes=wattage,model" + +Output:: + + { + "thingTypeName": "LightBulb", + "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb", + "thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190" + } + +For more information, see `Thing Types `__ in the *AWS IoT Developers Guide*. diff --git a/bin/awscli/examples/iot/create-thing.rst b/bin/awscli/examples/iot/create-thing.rst new file mode 100644 index 00000000..4469bf10 --- /dev/null +++ b/bin/awscli/examples/iot/create-thing.rst @@ -0,0 +1,33 @@ +**Example 1: To create a thing record in the registry** + +The following ``create-thing`` example creates an entry for a device in the AWS IoT thing registry. :: + + aws iot create-thing \ + --thing-name SampleIoTThing + +Output:: + + { + "thingName": "SampleIoTThing", + "thingArn": "arn:aws:iot:us-west-2: 123456789012:thing/SampleIoTThing", + "thingId": " EXAMPLE1-90ab-cdef-fedc-ba987EXAMPLE " + } + +**Example 2: To define a thing that is associated with a thing type** + +The following ``create-thing`` example create a thing that has the specified thing type and its attributes. :: + + aws iot create-thing \ + --thing-name "MyLightBulb" \ + --thing-type-name "LightBulb" \ + --attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}" + +Output:: + + { + "thingName": "MyLightBulb", + "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb", + "thingId": "40da2e73-c6af-406e-b415-15acae538797" + } + +For more information, see `How to Manage Things with the Registry `__ and `Thing Types `__ in the *AWS IoT Developers Guide*. diff --git a/bin/awscli/examples/iot/delete-thing.rst b/bin/awscli/examples/iot/delete-thing.rst new file mode 100644 index 00000000..04668cd1 --- /dev/null +++ b/bin/awscli/examples/iot/delete-thing.rst @@ -0,0 +1,9 @@ +**To display detailed information about a thing** + +The following ``delete-thing`` example deletes a thing from the AWS IoT registry for your AWS account. + + aws iot delete-thing --thing-name "FourthBulb" + +This command produces no output. + +For more information, see `How to Manage Things with the Registry `__ in the *AWS IoT Developers Guide*. diff --git a/bin/awscli/examples/iot/describe-thing-type.rst b/bin/awscli/examples/iot/describe-thing-type.rst new file mode 100644 index 00000000..4f429c46 --- /dev/null +++ b/bin/awscli/examples/iot/describe-thing-type.rst @@ -0,0 +1,27 @@ +**To get information about a thing type** + +The following ``describe-thing-type`` example display information about the specified thing type defined in your AWS account. :: + + aws iot describe-thing-type \ + --thing-type-name "LightBulb" + +Output:: + + { + "thingTypeName": "LightBulb", + "thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190", + "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb", + "thingTypeProperties": { + "thingTypeDescription": "light bulb type", + "searchableAttributes": [ + "model", + "wattage" + ] + }, + "thingTypeMetadata": { + "deprecated": false, + "creationDate": 1559772562.498 + } + } + +For more information, see `Thing Types `__ in the *AWS IoT Developers Guide*. diff --git a/bin/awscli/examples/iot/describe-thing.rst b/bin/awscli/examples/iot/describe-thing.rst new file mode 100644 index 00000000..2fa247c1 --- /dev/null +++ b/bin/awscli/examples/iot/describe-thing.rst @@ -0,0 +1,23 @@ +**To display detailed information about a thing** + +The following ``describe-thing`` example display information about a thing (device) that is defined in the AWS IoT registry for your AWS account. + + aws iot describe-thing \ + --thing-name "MyLightBulb" + +Output:: + + { + "defaultClientId": "MyLightBulb", + "thingName": "MyLightBulb", + "thingId": "40da2e73-c6af-406e-b415-15acae538797", + "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb", + "thingTypeName": "LightBulb", + "attributes": { + "model": "123", + "wattage": "75" + }, + "version": 1 + } + +For more information, see `How to Manage Things with the Registry `__ in the *AWS IoT Developers Guide*. diff --git a/bin/awscli/examples/iot/list-thing-types.rst b/bin/awscli/examples/iot/list-thing-types.rst new file mode 100644 index 00000000..5cb2299c --- /dev/null +++ b/bin/awscli/examples/iot/list-thing-types.rst @@ -0,0 +1,29 @@ +**To list the defined thing types** + +The following ``list-thing-types`` example displays a list of thing types defined in your AWS account. :: + + aws iot list-thing-types + +Output:: + + { + "thingTypes": [ + { + "thingTypeName": "LightBulb", + "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb", + "thingTypeProperties": { + "thingTypeDescription": "light bulb type", + "searchableAttributes": [ + "model", + "wattage" + ] + }, + "thingTypeMetadata": { + "deprecated": false, + "creationDate": 1559772562.498 + } + } + ] + } + +For more information, see `Thing Types `__ in the *AWS IoT Developers Guide*. diff --git a/bin/awscli/examples/iot/list-things.rst b/bin/awscli/examples/iot/list-things.rst new file mode 100644 index 00000000..4a62e048 --- /dev/null +++ b/bin/awscli/examples/iot/list-things.rst @@ -0,0 +1,84 @@ +**Example 1: To list all things in the registry** + +The following ``list-things`` example lists the things (devices) that are defined in the AWS IoT registry for your AWS account. :: + + aws iot list-things + +Output:: + + { + "things": [ + { + "thingName": "ThirdBulb", + "thingTypeName": "LightBulb", + "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/ThirdBulb", + "attributes": { + "model": "123", + "wattage": "75" + }, + "version": 2 + }, + { + "thingName": "MyOtherLightBulb", + "thingTypeName": "LightBulb", + "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb", + "attributes": { + "model": "123", + "wattage": "75" + }, + "version": 3 + }, + { + "thingName": "MyLightBulb", + "thingTypeName": "LightBulb", + "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb", + "attributes": { + "model": "123", + "wattage": "75" + }, + "version": 1 + }, + { + "thingName": "SampleIoTThing", + "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/SampleIoTThing", + "attributes": {}, + "version": 1 + } + ] + } + +**Example 2: To list the defined things that have a specific attribute** + +The following ``list-things`` example displays a list of things that have an attribute named ``wattage``. :: + + aws iot list-things \ + --attribute-name wattage + +Output:: + + { + "things": [ + { + "thingName": "MyLightBulb", + "thingTypeName": "LightBulb", + "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb", + "attributes": { + "model": "123", + "wattage": "75" + }, + "version": 1 + }, + { + "thingName": "MyOtherLightBulb", + "thingTypeName": "LightBulb", + "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb", + "attributes": { + "model": "123", + "wattage": "75" + }, + "version": 3 + } + ] + } + +For more information, see `How to Manage Things with the Registry `__ in the *AWS IoT Developers Guide*. diff --git a/bin/awscli/examples/iot/update-thing.rst b/bin/awscli/examples/iot/update-thing.rst new file mode 100644 index 00000000..085e334d --- /dev/null +++ b/bin/awscli/examples/iot/update-thing.rst @@ -0,0 +1,12 @@ +**To associate a thing with a thing type** + +The following ``update-thing`` example associates a thing in the AWS IoT registry with a thing type. When you make the association, you provide values for the attributes defined by the thing type. :: + + aws iot update-thing \ + --thing-name "MyOtherLightBulb" \ + --thing-type-name "LightBulb" \ + --attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}" + +This command does not produce output. Use the ``describe-thing`` command to see the result. + +For more information, see `Thing Types `__ in the *AWS IoT Developers Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/associate-entity-to-thing.rst b/bin/awscli/examples/iotthingsgraph/associate-entity-to-thing.rst new file mode 100644 index 00000000..5831a34b --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/associate-entity-to-thing.rst @@ -0,0 +1,11 @@ +**To associate a thing with a device** + +The following ``associate-entity-to-thing`` example associates a thing with a device. The example uses a motion sensor device that is in the public namespace. :: + + aws iotthingsgraph associate-entity-to-thing \ + --thing-name "MotionSensorName" \ + --entity-id "urn:tdm:aws/examples:Device:HCSR501MotionSensor" + +This command produces no output. + +For more information, see `Creating and Uploading Models `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/create-flow-template.rst b/bin/awscli/examples/iotthingsgraph/create-flow-template.rst new file mode 100644 index 00000000..6107b290 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/create-flow-template.rst @@ -0,0 +1,18 @@ +**To create a flow** + +The following ``create-flow-template`` example creates a flow (workflow). The value of ``MyFlowDefinition`` is the GraphQL that models the flow. :: + + aws iotthingsgraph create-flow-template \ + --definition language=GRAPHQL,text="MyFlowDefinition" + +Output:: + + { + "summary": { + "createdAt": 1559248067.545, + "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", + "revisionNumber": 1 + } + } + +For more information, see `Working with Flows `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/create-system-instance.rst b/bin/awscli/examples/iotthingsgraph/create-system-instance.rst new file mode 100644 index 00000000..dceb91ad --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/create-system-instance.rst @@ -0,0 +1,23 @@ +**To create a system instance** + +The following ``create-system-instance`` example creates a system instance. The value of ``MySystemInstanceDefinition`` is the GraphQL that models the system instance. :: + + aws iotthingsgraph create-system-instance -\ + -definition language=GRAPHQL,text="MySystemInstanceDefinition" \ + --target CLOUD \ + --flow-actions-role-arn myRoleARN + +Output:: + + { + "summary": { + "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218", + "status": "NOT_DEPLOYED", + "target": "CLOUD", + "createdAt": 1559249315.208, + "updatedAt": 1559249315.208 + } + } + +For more information, see `Working with Systems and Flow Configurations `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/create-system-template.rst b/bin/awscli/examples/iotthingsgraph/create-system-template.rst new file mode 100644 index 00000000..6ffde18b --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/create-system-template.rst @@ -0,0 +1,19 @@ +**To create a system** + +The following ``create-system-template`` example creates a system. The value of MySystemDefinition is the GraphQL that models the system. :: + + aws iotthingsgraph create-system-template \ + --definition language=GRAPHQL,text="MySystemDefinition" + +Output:: + + { + "summary": { + "createdAt": 1559249776.254, + "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MySystem", + "revisionNumber": 1 + } + } + +For more information, see `Creating Systems `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/delete-flow-template.rst b/bin/awscli/examples/iotthingsgraph/delete-flow-template.rst new file mode 100644 index 00000000..14c29545 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/delete-flow-template.rst @@ -0,0 +1,10 @@ +**To delete a flow** + +The following ``delete-flow-template`` example deletes a flow (workflow). :: + + aws iotthingsgraph delete-flow-template \ + --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow" + +This command produces no output. + +For more information, see `Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems, and Deployments `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/delete-namespace.rst b/bin/awscli/examples/iotthingsgraph/delete-namespace.rst new file mode 100644 index 00000000..10dbc4c0 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/delete-namespace.rst @@ -0,0 +1,14 @@ +**To delete a namespace** + +The following ``delete-namespace`` example deletes a namespace. :: + + aws iotthingsgraph delete-namespace + +Output:: + + { + "namespaceArn": "arn:aws:iotthingsgraph:us-west-2:123456789012", + "namespaceName": "us-west-2/123456789012/default" + } + +For more information, see `Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems, and Deployments `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/delete-system-instance.rst b/bin/awscli/examples/iotthingsgraph/delete-system-instance.rst new file mode 100644 index 00000000..91c75d72 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/delete-system-instance.rst @@ -0,0 +1,10 @@ +**To delete a system instance** + +The following ``delete-system-instance`` example deletes a system instance. :: + + aws iotthingsgraph delete-system-instance \ + --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218" + +This command produces no output. + +For more information, see `Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems, and Deployments `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/delete-system-template.rst b/bin/awscli/examples/iotthingsgraph/delete-system-template.rst new file mode 100644 index 00000000..54da0749 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/delete-system-template.rst @@ -0,0 +1,10 @@ +**To delete a system** + +The following ``delete-system-template`` example deletes a system. :: + + aws iotthingsgraph delete-system-template \ + --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" + +This command produces no output. + +For more information, see `Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems, and Deployments `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/deploy-system-instance.rst b/bin/awscli/examples/iotthingsgraph/deploy-system-instance.rst new file mode 100644 index 00000000..46a94969 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/deploy-system-instance.rst @@ -0,0 +1,21 @@ +**To deploy a system instance** + +The following ``delete-system-template`` example deploys a system instance. :: + + aws iotthingsgraph deploy-system-instance \ + --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218" + +Output:: + + { + "summary": { + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment:Room218", + "createdAt": 1559249776.254, + "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", + "status": "DEPLOYED_IN_TARGET", + "target": "CLOUD", + "updatedAt": 1559249776.254 + } + } + +For more information, see `Working with Systems and Flow Configurations `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/deprecate-flow-template.rst b/bin/awscli/examples/iotthingsgraph/deprecate-flow-template.rst new file mode 100644 index 00000000..4260768f --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/deprecate-flow-template.rst @@ -0,0 +1,10 @@ +**To deprecate a flow** + +The following ``deprecate-flow-template`` example deprecates a flow (workflow). :: + + aws iotthingsgraph deprecate-flow-template \ + --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow" + +This command produces no output. + +For more information, see `Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems, and Deployments `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/deprecate-system-template.rst b/bin/awscli/examples/iotthingsgraph/deprecate-system-template.rst new file mode 100644 index 00000000..d2ca79b6 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/deprecate-system-template.rst @@ -0,0 +1,10 @@ +**To deprecate a system** + +The following ``deprecate-system-template`` example deprecates a system. :: + + aws iotthingsgraph deprecate-system-template \ + --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" + +This command produces no output. + +For more information, see `Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems, and Deployments `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/describe-namespace.rst b/bin/awscli/examples/iotthingsgraph/describe-namespace.rst new file mode 100644 index 00000000..806eab56 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/describe-namespace.rst @@ -0,0 +1,16 @@ +**To get a description of your namespace** + +The following ``describe-namespace`` example gets a description of your namespace. :: + + aws iotthingsgraph describe-namespace + +Output:: + + { + "namespaceName": "us-west-2/123456789012/default", + "trackingNamespaceName": "aws", + "trackingNamespaceVersion": 1, + "namespaceVersion": 5 + } + +For more information, see `Namespaces `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/dissociate-entity-from-thing.rst b/bin/awscli/examples/iotthingsgraph/dissociate-entity-from-thing.rst new file mode 100644 index 00000000..46bdeff7 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/dissociate-entity-from-thing.rst @@ -0,0 +1,11 @@ +**To dissociate a thing from a device** + +The following ``dissociate-entity-from-thing`` example dissociates a thing from a device. :: + + aws iotthingsgraph dissociate-entity-from-thing \ + --thing-name "MotionSensorName" \ + --entity-type "DEVICE" + +This command produces no output. + +For more information, see `Creating and Uploading Models `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/get-entities.rst b/bin/awscli/examples/iotthingsgraph/get-entities.rst new file mode 100644 index 00000000..6361006c --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/get-entities.rst @@ -0,0 +1,24 @@ +**To get definitions for entities** + +The following ``get-entities`` example gets a definition for a device model. :: + + aws iotthingsgraph get-entities \ + --ids "urn:tdm:aws/examples:DeviceModel:MotionSensor" + +Output:: + + { + "descriptions": [ + { + "id": "urn:tdm:aws/examples:DeviceModel:MotionSensor", + "type": "DEVICE_MODEL", + "createdAt": 1559256190.599, + "definition": { + "language": "GRAPHQL", + "text": "##\n# Specification of motion sensor devices interface.\n##\ntype MotionSensor @deviceModel(id: \"urn:tdm:aws/examples:deviceModel:MotionSensor\",\n capability: \"urn:tdm:aws/examples:capability:MotionSensorCapability\") {ignore:void}" + } + } + ] + } + +For more information, see `Creating and Uploading Models `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/get-flow-template-revisions.rst b/bin/awscli/examples/iotthingsgraph/get-flow-template-revisions.rst new file mode 100644 index 00000000..df44b612 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/get-flow-template-revisions.rst @@ -0,0 +1,20 @@ +**To get revision information about a flow** + +The following ``get-flow-template-revisions`` example gets revision information about a flow (workflow). :: + + aws iotthingsgraph get-flow-template-revisions \ + --id urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow + +Output:: + + { + "summaries": [ + { + "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", + "revisionNumber": 1, + "createdAt": 1559247540.292 + } + ] + } + +For more information, see `Working with Flows `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/get-flow-template.rst b/bin/awscli/examples/iotthingsgraph/get-flow-template.rst new file mode 100644 index 00000000..770947d6 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/get-flow-template.rst @@ -0,0 +1,25 @@ +**To get a flow definition** + +The following ``get-flow-template`` example gets a definition for a flow (workflow). :: + + aws iotthingsgraph get-flow-template \ + --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow" + +Output:: + + { + "description": { + "summary": { + "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", + "revisionNumber": 1, + "createdAt": 1559247540.292 + }, + "definition": { + "language": "GRAPHQL", + "text": "{\nquery MyFlow($camera: string!, $screen: string!) @workflowType(id: \"urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow\") @annotation(type: \"tgc:FlowEvent\", id: \"sledged790c1b2bcd949e09da0c9bfc077f79d\", x: 1586, y: 653) @triggers(definition: \"{MotionSensor(description: \\\"\\\") @position(x: 1045, y: 635.6666564941406) {\\n condition(expr: \\\"devices[name == \\\\\\\"motionSensor\\\\\\\"].events[name == \\\\\\\"StateChanged\\\\\\\"].lastEvent\\\")\\n action(expr: \\\"\\\")\\n}}\") {\n variables {\n cameraResult @property(id: \"urn:tdm:aws/examples:property:CameraStateProperty\")\n }\n steps {\n step(name: \"Camera\", outEvent: [\"sledged790c1b2bcd949e09da0c9bfc077f79d\"]) @position(x: 1377, y: 638.6666564941406) {\n DeviceActivity(deviceModel: \"urn:tdm:aws/examples:deviceModel:Camera\", out: \"cameraResult\", deviceId: \"${camera}\") {\n capture\n }\n }\n step(name: \"Screen\", inEvent: [\"sledged790c1b2bcd949e09da0c9bfc077f79d\"]) @position(x: 1675.6666870117188, y: 637.9999847412109) {\n DeviceActivity(deviceModel: \"urn:tdm:aws/examples:deviceModel:Screen\", deviceId: \"${screen}\") {\n display(imageUrl: \"${cameraResult.lastClickedImage}\")\n }\n }\n }\n}\n}" + }, + "validatedNamespaceVersion": 5 + } + } + +For more information, see `Working with Flows `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/get-namespace-deletion-status.rst b/bin/awscli/examples/iotthingsgraph/get-namespace-deletion-status.rst new file mode 100644 index 00000000..c584f39d --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/get-namespace-deletion-status.rst @@ -0,0 +1,15 @@ +**To get the status of the namespace deletion task** + +The following ``get-namespace-deletion-status`` example gets the status of the namespace deletion task. :: + + aws iotthingsgraph get-namespace-deletion-status + +Output:: + + { + "namespaceArn": "arn:aws:iotthingsgraph:us-west-2:123456789012", + "namespaceName": "us-west-2/123456789012/default" + "status": "SUCCEEDED " + } + +For more information, see `Namespaces `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/get-system-instance.rst b/bin/awscli/examples/iotthingsgraph/get-system-instance.rst new file mode 100644 index 00000000..254f29ce --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/get-system-instance.rst @@ -0,0 +1,32 @@ +**To get a system instance** + +The following ``get-system-instance`` example gets a definition for a system instance. :: + + aws iotthingsgraph get-system-instance \ + --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218" + +Output:: + + { + "description": { + "summary": { + "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218", + "status": "NOT_DEPLOYED", + "target": "CLOUD", + "createdAt": 1559249315.208, + "updatedAt": 1559249315.208 + }, + "definition": { + "language": "GRAPHQL", + "text": "{\r\nquery Room218 @deployment(id: \"urn:tdm:us-west-2/123456789012/default:Deployment:Room218\", systemId: \"urn:tdm:us-west-2/123456789012/default:System:SecurityFlow\") {\r\n motionSensor(deviceId: \"MotionSensorName\")\r\n screen(deviceId: \"ScreenName\")\r\n camera(deviceId: \"CameraName\") \r\n triggers {MotionEventTrigger(description: \"a trigger\") { \r\n condition(expr: \"devices[name == 'motionSensor'].events[name == 'StateChanged'].lastEvent\") \r\n action(expr: \"ThingsGraph.startFlow('SecurityFlow', bindings[name == 'camera'].deviceId, bindings[name == 'screen'].deviceId)\")\r\n }\r\n }\r\n }\r\n }" + }, + "metricsConfiguration": { + "cloudMetricEnabled": false + }, + "validatedNamespaceVersion": 5, + "flowActionsRoleArn": "arn:aws:iam::123456789012:role/ThingsGraphRole" + } + } + +For more information, see `Working with Systems and Flow Configurations `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/get-system-template-revisions.rst b/bin/awscli/examples/iotthingsgraph/get-system-template-revisions.rst new file mode 100644 index 00000000..a23b4f94 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/get-system-template-revisions.rst @@ -0,0 +1,21 @@ +**To get revision information about a system** + +The following ``get-system-template-revisions`` example gets revision information about a system. :: + + aws iotthingsgraph get-system-template-revisions \ + --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" + +Output:: + + { + "summaries": [ + { + "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MySystem", + "revisionNumber": 1, + "createdAt": 1559247540.656 + } + ] + } + +For more information, see `Working with Systems and Flow Configurations `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/get-system-template.rst b/bin/awscli/examples/iotthingsgraph/get-system-template.rst new file mode 100644 index 00000000..a9ebe6dd --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/get-system-template.rst @@ -0,0 +1,26 @@ +**To get a system** + +The following ``get-system-template`` example gets a definition for a system. :: + + aws iotthingsgraph get-system-template \ + --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" + +Output:: + + { + "description": { + "summary": { + "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MyFlow", + "revisionNumber": 1, + "createdAt": 1559247540.656 + }, + "definition": { + "language": "GRAPHQL", + "text": "{\ntype MySystem @systemType(id: \"urn:tdm:us-west-2/123456789012/default:System:MySystem\", description: \"\") {\n camera: Camera @thing(id: \"urn:tdm:aws/examples:deviceModel:Camera\")\n screen: Screen @thing(id: \"urn:tdm:aws/examples:deviceModel:Screen\")\n motionSensor: MotionSensor @thing(id: \"urn:tdm:aws/examples:deviceModel:MotionSensor\")\n MyFlow: MyFlow @workflow(id: \"urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow\")\n}\n}" + }, + "validatedNamespaceVersion": 5 + } + } + +For more information, see `Working with Systems and Flow Configurations `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/get-upload-status.rst b/bin/awscli/examples/iotthingsgraph/get-upload-status.rst new file mode 100644 index 00000000..b7a7fd4c --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/get-upload-status.rst @@ -0,0 +1,17 @@ +**To get the status of your entity upload** + +The following ``get-upload-status`` example gets the status of your entity upload operation. The value of ``MyUploadId`` is the ID value returned by the ``upload-entity-definitions`` operation. :: + + aws iotthingsgraph get-upload-status \ + --upload-id "MyUploadId" + +Output:: + + { + "namespaceName": "us-west-2/123456789012/default", + "namespaceVersion": 5, + "uploadId": "f6294f1e-b109-4bbe-9073-f451a2dda2da", + "uploadStatus": "SUCCEEDED" + } + +For more information, see `Modeling Entities `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/list-flow-execution-messages.rst b/bin/awscli/examples/iotthingsgraph/list-flow-execution-messages.rst new file mode 100644 index 00000000..44b29142 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/list-flow-execution-messages.rst @@ -0,0 +1,21 @@ +**To get information about events in a flow execution** + +The following ``list-flow-execution-messages`` example gets information about events in a flow execution. :: + + aws iotthingsgraph list-flow-execution-messages \ + --flow-execution-id "urn:tdm:us-west-2/123456789012/default:Workflow:SecurityFlow_2019-05-11T19:39:55.317Z_MotionSensor_69b151ad-a611-42f5-ac21-fe537f9868ad" + +Output:: + + { + "messages": [ + { + "eventType": "EXECUTION_STARTED", + "messageId": "f6294f1e-b109-4bbe-9073-f451a2dda2da", + "payload": "Flow execution started", + "timestamp": 1559247540.656 + } + ] + } + +For more information, see `Working with Flows `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/list-tags-for-resource.rst b/bin/awscli/examples/iotthingsgraph/list-tags-for-resource.rst new file mode 100644 index 00000000..02e454d3 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/list-tags-for-resource.rst @@ -0,0 +1,19 @@ +**To list all tags for a resource** + +The following ``list-tags-for-resource`` example list all tags for an AWS IoT Things Graph resource. :: + + aws iotthingsgraph list-tags-for-resource \ + --resource-arn "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218" + +Output:: + + { + "tags": [ + { + "key": "Type", + "value": "Residential" + } + ] + } + +For more information, see `Tagging Your AWS IoT Things Graph Resources `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/search-entities.rst b/bin/awscli/examples/iotthingsgraph/search-entities.rst new file mode 100644 index 00000000..8c5a674d --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/search-entities.rst @@ -0,0 +1,40 @@ +**To search for entities** + +The following ``search-entities`` example searches for all entities of type ``EVENT``. :: + + aws iotthingsgraph search-entities \ + --entity-types "EVENT" + +Output:: + + { + "descriptions": [ + { + "id": "urn:tdm:aws/examples:Event:MotionSensorEvent", + "type": "EVENT", + "definition": { + "language": "GRAPHQL", + "text": "##\n# Description of events emitted by motion sensor.\n##\ntype MotionSensorEvent @eventType(id: \"urn:tdm:aws/examples:event:MotionSensorEvent\",\n payload: \"urn:tdm:aws/examples:property:MotionSensorStateProperty\") {ignore:void}" + } + }, + { + "id": "urn:tdm:us-west-2/123456789012/default:Event:CameraClickedEventV2", + "type": "EVENT", + "definition": { + "language": "GRAPHQL", + "text": "type CameraClickedEventV2 @eventType(id: \"urn:tdm:us-west-2/123456789012/default:event:CameraClickedEventV2\",\r\npayload: \"urn:tdm:aws:Property:Boolean\"){ignore:void}" + } + }, + { + "id": "urn:tdm:us-west-2/123456789012/default:Event:MotionSensorEventV2", + "type": "EVENT", + "definition": { + "language": "GRAPHQL", + "text": "# Event emitted by the motion sensor.\r\ntype MotionSensorEventV2 @eventType(id: \"urn:tdm:us-west-2/123456789012/default:event:MotionSensorEventV2\",\r\npayload: \"urn:tdm:us-west-2/123456789012/default:property:MotionSensorStateProperty2\") {ignore:void}" + } + } + ], + "nextToken": "urn:tdm:us-west-2/123456789012/default:Event:MotionSensorEventV2" + } + +For more information, see `AWS IoT Things Graph Data Model Reference `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/search-flow-executions.rst b/bin/awscli/examples/iotthingsgraph/search-flow-executions.rst new file mode 100644 index 00000000..9057dd56 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/search-flow-executions.rst @@ -0,0 +1,23 @@ +**To search for flow executions** + +The following ``search-flow-executions`` example search for all executions of a flow in a specified system instance. :: + + aws iotthingsgraph search-flow-executions \ + --system-instance-id "urn:tdm:us-west-2/123456789012/default:Deployment:Room218" + +Output:: + + { + "summaries": [ + { + "createdAt": 1559247540.656, + "flowExecutionId": "f6294f1e-b109-4bbe-9073-f451a2dda2da", + "flowTemplateId": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", + "status": "RUNNING ", + "systemInstanceId": "urn:tdm:us-west-2/123456789012/default:System:MySystem", + "updatedAt": 1559247540.656 + } + ] + } + +For more information, see `Working with Systems and Flow Configurations `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/search-flow-templates.rst b/bin/awscli/examples/iotthingsgraph/search-flow-templates.rst new file mode 100644 index 00000000..3e8aec05 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/search-flow-templates.rst @@ -0,0 +1,25 @@ +**To search for flows (or workflows)** + +The following ``search-flow-templates`` example searches for all flows (workflows) that contain the Camera device model. :: + + aws iotthingsgraph search-flow-templates \ + --filters name="DEVICE_MODEL_ID",value="urn:tdm:aws/examples:DeviceModel:Camera" + +Output:: + + { + "summaries": [ + { + "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", + "revisionNumber": 1, + "createdAt": 1559247540.292 + }, + { + "id": "urn:tdm:us-west-2/123456789012/default:Workflow:SecurityFlow", + "revisionNumber": 3, + "createdAt": 1548283099.27 + } + ] + } + +For more information, see `Working with Flows `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/search-system-instances.rst b/bin/awscli/examples/iotthingsgraph/search-system-instances.rst new file mode 100644 index 00000000..50b2fb96 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/search-system-instances.rst @@ -0,0 +1,63 @@ +**To search for system instances** + +The following ``search-system-instances`` example searches for all system instances that contain the specified system. :: + + aws iotthingsgraph search-system-instances \ + --filters name="SYSTEM_TEMPLATE_ID",value="urn:tdm:us-west-2/123456789012/default:System:SecurityFlow" + +Output:: + + { + "summaries": [ + { + "id": "urn:tdm:us-west-2/123456789012/default:Deployment:DeploymentForSample", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/DeploymentForSample", + "status": "NOT_DEPLOYED", + "target": "GREENGRASS", + "greengrassGroupName": "ThingsGraphGrnGr", + "createdAt": 1555716314.707, + "updatedAt": 1555716314.707 + }, + { + "id": "urn:tdm:us-west-2/123456789012/default:Deployment:MockDeployment", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/MockDeployment", + "status": "DELETED_IN_TARGET", + "target": "GREENGRASS", + "greengrassGroupName": "ThingsGraphGrnGr", + "createdAt": 1549416462.049, + "updatedAt": 1549416722.361, + "greengrassGroupId": "01d04b07-2a51-467f-9d03-0c90b3cdcaaf", + "greengrassGroupVersionId": "7365aed7-2d3e-4d13-aad8-75443d45eb05" + }, + { + "id": "urn:tdm:us-west-2/123456789012/default:Deployment:MockDeployment2", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/MockDeployment2", + "status": "DEPLOYED_IN_TARGET", + "target": "GREENGRASS", + "greengrassGroupName": "ThingsGraphGrnGr", + "createdAt": 1549572385.774, + "updatedAt": 1549572418.408, + "greengrassGroupId": "01d04b07-2a51-467f-9d03-0c90b3cdcaaf", + "greengrassGroupVersionId": "bfa70ab3-2bf7-409c-a4d4-bc8328ae5b86" + }, + { + "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room215", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room215", + "status": "NOT_DEPLOYED", + "target": "GREENGRASS", + "greengrassGroupName": "ThingsGraphGG", + "createdAt": 1547056918.413, + "updatedAt": 1547056918.413 + }, + { + "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room218", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218", + "status": "NOT_DEPLOYED", + "target": "CLOUD", + "createdAt": 1559249315.208, + "updatedAt": 1559249315.208 + } + ] + } + +For more information, see `Working with Systems and Flow Configurations `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/search-system-templates.rst b/bin/awscli/examples/iotthingsgraph/search-system-templates.rst new file mode 100644 index 00000000..5c570f52 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/search-system-templates.rst @@ -0,0 +1,21 @@ +**To search for system** + +The following ``search-system-templates`` example searches for all systems that contain the specified flow. :: + + aws iotthingsgraph search-system-templates \ + --filters name="FLOW_TEMPLATE_ID",value="urn:tdm:us-west-2/123456789012/default:Workflow:SecurityFlow" + +Output:: + + { + "summaries": [ + { + "id": "urn:tdm:us-west-2/123456789012/default:System:SecurityFlow", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/SecurityFlow", + "revisionNumber": 1, + "createdAt": 1548283099.433 + } + ] + } + +For more information, see `Working with Flows `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/search-things.rst b/bin/awscli/examples/iotthingsgraph/search-things.rst new file mode 100644 index 00000000..c403f6d0 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/search-things.rst @@ -0,0 +1,23 @@ +**To search for things associated with devices and device models** + +The following ``search-things`` example searches for all things that are associated with the HCSR501MotionSensor device. :: + + aws iotthingsgraph search-things \ + --entity-id "urn:tdm:aws/examples:Device:HCSR501MotionSensor" + +Output:: + + { + "things": [ + { + "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MotionSensor1", + "thingName": "MotionSensor1" + }, + { + "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/TG_MS", + "thingName": "TG_MS" + } + ] + } + +For more information, see `Creating and Uploading Models `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/tag-resource.rst b/bin/awscli/examples/iotthingsgraph/tag-resource.rst new file mode 100644 index 00000000..68824e0e --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/tag-resource.rst @@ -0,0 +1,11 @@ +**To create a tag for a resource** + +The following ``tag-resource`` example creates a tag for the specified resource. :: + + aws iotthingsgraph tag-resource \ + --resource-arn "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218" \ + --tags key="Type",value="Residential" + +This command produces no output. + +For more information, see `Tagging Your AWS IoT Things Graph Resources `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/undeploy-system-instance.rst b/bin/awscli/examples/iotthingsgraph/undeploy-system-instance.rst new file mode 100644 index 00000000..7413a37e --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/undeploy-system-instance.rst @@ -0,0 +1,24 @@ +**To undeploy a system instance from its target** + +The following ``undeploy-system-instance`` example removes a system instance from its target. :: + + aws iotthingsgraph undeploy-system-instance \ + --id "urn:tdm:us-west-2/123456789012/default:Deployment:Room215" + +Output:: + + { + "summary": { + "id": "urn:tdm:us-west-2/123456789012/default:Deployment:Room215", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room215", + "status": "PENDING_DELETE", + "target": "GREENGRASS", + "greengrassGroupName": "ThingsGraphGrnGr", + "createdAt": 1553189694.255, + "updatedAt": 1559344549.601, + "greengrassGroupId": "01d04b07-2a51-467f-9d03-0c90b3cdcaaf", + "greengrassGroupVersionId": "731b371d-d644-4b67-ac64-3934e99b75d7" + } + } + +For more information, see `Lifecycle Management for AWS IoT Things Graph Entities, Flows, Systems, and Deployments `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/untag-resource.rst b/bin/awscli/examples/iotthingsgraph/untag-resource.rst new file mode 100644 index 00000000..028eca1e --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/untag-resource.rst @@ -0,0 +1,11 @@ +**To remove a tag for a resource** + +The following ``untag-resource`` example removes a tag for the specified resource. :: + + aws iotthingsgraph untag-resource \ + --resource-arn "arn:aws:iotthingsgraph:us-west-2:123456789012:Deployment/default/Room218" \ + --tag-keys "Type" + +This command produces no output. + +For more information, see `Tagging Your AWS IoT Things Graph Resources `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/update-flow-template.rst b/bin/awscli/examples/iotthingsgraph/update-flow-template.rst new file mode 100644 index 00000000..3cdec514 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/update-flow-template.rst @@ -0,0 +1,19 @@ +**To update a flow** + +The following ``update-flow-template`` example updates a flow (workflow). The value of ``MyFlowDefinition`` is the GraphQL that models the flow. :: + + aws iotthingsgraph update-flow-template \ + --id "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow" \ + --definition language=GRAPHQL,text="MyFlowDefinition" + +Output:: + + { + "summary": { + "createdAt": 1559248067.545, + "id": "urn:tdm:us-west-2/123456789012/default:Workflow:MyFlow", + "revisionNumber": 2 + } + } + +For more information, see `Working with Flows `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/update-system-template.rst b/bin/awscli/examples/iotthingsgraph/update-system-template.rst new file mode 100644 index 00000000..7a6fcbdf --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/update-system-template.rst @@ -0,0 +1,20 @@ +**To update a system** + +The following ``update-system-template`` example updates a system. The value of ``MySystemDefinition`` is the GraphQL that models the system. :: + + aws iotthingsgraph update-system-template \ + --id "urn:tdm:us-west-2/123456789012/default:System:MySystem" \ + --definition language=GRAPHQL,text="MySystemDefinition" + +Output:: + + { + "summary": { + "createdAt": 1559249776.254, + "id": "urn:tdm:us-west-2/123456789012/default:System:MySystem", + "arn": "arn:aws:iotthingsgraph:us-west-2:123456789012:System/default/MySystem", + "revisionNumber": 2 + } + } + +For more information, see `Creating Systems `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/iotthingsgraph/upload-entity-definitions.rst b/bin/awscli/examples/iotthingsgraph/upload-entity-definitions.rst new file mode 100644 index 00000000..e99f5de7 --- /dev/null +++ b/bin/awscli/examples/iotthingsgraph/upload-entity-definitions.rst @@ -0,0 +1,14 @@ +**To upload entity definitions** + +The following ``upload-entity-definitions`` example uploads entity definitions to your namespace. The value of ``MyEntityDefinitions`` is the GraphQL that models the entities. :: + + aws iotthingsgraph upload-entity-definitions \ + --document language=GRAPHQL,text="MyEntityDefinitions" + +Output:: + + { + "uploadId": "f6294f1e-b109-4bbe-9073-f451a2dda2da" + } + +For more information, see `Modeling Entities `__ in the *AWS IoT Things Graph User Guide*. diff --git a/bin/awscli/examples/lightsail/get-instance-metric-data.rst b/bin/awscli/examples/lightsail/get-instance-metric-data.rst new file mode 100755 index 00000000..acc506d7 --- /dev/null +++ b/bin/awscli/examples/lightsail/get-instance-metric-data.rst @@ -0,0 +1,32 @@ +**To get instance NetworkOut metric data for a month period** + +The following ``get-instance-metric-data`` example outputs the total ``NetworkOut`` metric data in bytes for an approximate month-long period. + +We recommend that you use an epoch time converter to identify the start and end times. If the time between the ``--start-time`` and ``--end-time`` is greater than 2628000 seconds (approximately one month), then multiple results are returned for each 2628000 interval, as shown in the following sample response. :: + + aws lightsail get-instance-metric-data \ + --instance-name InstanceName \ + --metric-name NetworkOut \ + --period 2628000 \ + --start-time 1546304400 \ + --end-time 1577840400 + --unit Bytes + --statistics Sum + +Output:: + + { + "metricData": [ + { + "timestamp": 1556812800.0, + "sum": 22359134.0, + "unit": "Bytes" + }, + { + "timestamp": 1554184800.0, + "sum": 5968238.0, + "unit": "Bytes" + } + ], + "metricName": "NetworkOut" + } diff --git a/bin/awscli/examples/mediaconvert/cancel-job.rst b/bin/awscli/examples/mediaconvert/cancel-job.rst new file mode 100644 index 00000000..f5cfcae2 --- /dev/null +++ b/bin/awscli/examples/mediaconvert/cancel-job.rst @@ -0,0 +1,12 @@ +**To cancel a job that is in a queue** + +The following ``cancel-job`` example cancels the job with ID ``1234567891234-abc123``. You can't cancel a job that the service has started processing. :: + + aws mediaconvert cancel-job \ + --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ + --region region-name-1 \ + --id 1234567891234-abc123 + +To get your account-specific endpoint, use ``describe-endpoints``, or send the command without the endpoint. The service returns an error and your endpoint. + +For more information, see `Working with AWS Elemental MediaConvert Jobs `_ in the *AWS Elemental MediaConvert User Guide*. diff --git a/bin/awscli/examples/mediaconvert/create-job-template.rst b/bin/awscli/examples/mediaconvert/create-job-template.rst new file mode 100644 index 00000000..ceb3cfb8 --- /dev/null +++ b/bin/awscli/examples/mediaconvert/create-job-template.rst @@ -0,0 +1,18 @@ +**To create a job template** + +The following ``create-job-template`` example creates a job template with the transcoding settings that are specified in the file ``job-template.json`` that resides on your system. :: + + aws mediaconvert create-job-template \ + --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ + --region region-name-1 \ + --name JobTemplate1 \ + --cli-input-json file://~/job-template.json + +If you create your job template JSON file by using ``get-job-template`` and then modifying the file, remove the ``JobTemplate`` object, but keep the `Settings` child object inside it. Also, make sure to remove the following key-value pairs: ``LastUpdated``, ``Arn``, ``Type``, and ``CreatedAt``. You can specific the category, description, name, and queue either in the JSON file or at the command line. + +To get your account-specific endpoint, use ``describe-endpoints``, or send the command without the endpoint. The service returns an error and your endpoint. + +If your request is successful, the service returns the JSON specification for the job template that you created. + +For more information, see `Working with AWS Elemental MediaConvert Job Templates `_ in the *AWS Elemental MediaConvert User Guide*. + diff --git a/bin/awscli/examples/mediaconvert/create-job.rst b/bin/awscli/examples/mediaconvert/create-job.rst new file mode 100644 index 00000000..37b38450 --- /dev/null +++ b/bin/awscli/examples/mediaconvert/create-job.rst @@ -0,0 +1,16 @@ +**To create a job** + +The following ``create-job`` example creates a transcoding job with the settings that are specified in a file ``job.json`` that resides on the system that you send the command from. This JSON job specification might specify each setting individually, reference a job template, or reference output presets. :: + + aws mediaconvert create-job \ + --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ + --region region-name-1 \ + --cli-input-json file://~/job.json + +You can use the AWS Elemental MediaConvert console to generate the JSON job specification by choosing your job settings, and then choosing **Show job JSON** at the bottom of the **Job** section. + +To get your account-specific endpoint, use ``describe-endpoints``, or send the command without the endpoint. The service returns an error and your endpoint. + +If your request is successful, the service returns the JSON job specification that you sent with your request. + +For more information, see `Working with AWS Elemental MediaConvert Jobs `_ in the *AWS Elemental MediaConvert User Guide*. diff --git a/bin/awscli/examples/mediaconvert/create-preset.rst b/bin/awscli/examples/mediaconvert/create-preset.rst new file mode 100644 index 00000000..a98af78e --- /dev/null +++ b/bin/awscli/examples/mediaconvert/create-preset.rst @@ -0,0 +1,14 @@ +**To create a custom output preset** + +The following ``create-preset`` example creates a custom output preset based on the output settings that are specified in the file ``preset.json``. You can specify the category, description, and name either in the JSON file or at the command line. :: + + aws mediaconvert create-preset \ + --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com + --region region-name-1 \ + --cli-input-json file://~/preset.json + +If you create your preset JSON file by using ``get-preset`` and then modifying the output file, ensure that you remove the following key-value pairs: ``LastUpdated``, ``Arn``, ``Type``, and ``CreatedAt``. + +To get your account-specific endpoint, use ``describe-endpoints``, or send the command without the endpoint. The service returns an error and your endpoint. + +For more information, see `Working with AWS Elemental MediaConvert Output Presets `_ in the *AWS Elemental MediaConvert User Guide*. \ No newline at end of file diff --git a/bin/awscli/examples/mediaconvert/create-queue.rst b/bin/awscli/examples/mediaconvert/create-queue.rst new file mode 100644 index 00000000..5a80550d --- /dev/null +++ b/bin/awscli/examples/mediaconvert/create-queue.rst @@ -0,0 +1,27 @@ +**To create a custom queue** + +The following ``create-queue`` example creates a custom transcoding queue. :: + + aws mediaconvert create-queue \ + --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ + --region region-name-1 \ + --name Queue1 \ + --description "Keep this queue empty unless job is urgent." + +To get your account-specific endpoint, use ``describe-endpoints``, or send the command without the endpoint. The service returns an error and your endpoint. + +Output:: + + { + "Queue": { + "Status": "ACTIVE", + "Name": "Queue1", + "LastUpdated": 1518034928, + "Arn": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1", + "Type": "CUSTOM", + "CreatedAt": 1518034928, + "Description": "Keep this queue empty unless job is urgent." + } + } + +For more information, see `Working with AWS Elemental MediaConvert Queues `_ in the *AWS Elemental MediaConvert User Guide*. diff --git a/bin/awscli/examples/mediaconvert/describe-endpoints.rst b/bin/awscli/examples/mediaconvert/describe-endpoints.rst new file mode 100644 index 00000000..f9a62c7a --- /dev/null +++ b/bin/awscli/examples/mediaconvert/describe-endpoints.rst @@ -0,0 +1,18 @@ +**To get your account-specific endpoint** + +The following ``describe-endpoints`` example retrieves the endpoint that you need to send any other request to the service. :: + + aws mediaconvert describe-endpoints + +Output:: + + { + "Endpoints": [ + { + "Url": "https://abcd1234.mediaconvert.region-name-1.amazonaws.com" + } + ] + } + +For more information, see `Getting Started with MediaConvert Using the API `_ in the *AWS Elemental +MediaConvert API Reference*. diff --git a/bin/awscli/examples/mediaconvert/get-job.rst b/bin/awscli/examples/mediaconvert/get-job.rst new file mode 100644 index 00000000..2f1cd259 --- /dev/null +++ b/bin/awscli/examples/mediaconvert/get-job.rst @@ -0,0 +1,36 @@ +**To get details for a particular job** + +The following example requests the information for the job with ID ``1234567890987-1ab2c3``, which in this example ended in an error. :: + + aws mediaconvert get-job \ + --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ + --region region-name-1 \ + --id 1234567890987-1ab2c3 + +To get your account-specific endpoint, use ``describe-endpoints``, or send the command without the endpoint. The service returns an error and your endpoint. + +If your request is successful, the service returns a JSON file with job information, including job settings, any returned errors, and other job data, as follows:: + + { + "Job": { + "Status": "ERROR", + "Queue": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1", + "Settings": { + ...... + }, + "ErrorMessage": "Unable to open input file [s3://my-input-bucket/file-name.mp4]: [Failed probe/open: [Failed to read data: AssumeRole failed]]", + "ErrorCode": 1434, + "Role": "arn:aws:iam::012345678998:role/MediaConvertServiceRole", + "Arn": "arn:aws:mediaconvert:us-west-1:012345678998:jobs/1234567890987-1ab2c3", + "UserMetadata": {}, + "Timing": { + "FinishTime": 1517442131, + "SubmitTime": 1517442103, + "StartTime": 1517442104 + }, + "Id": "1234567890987-1ab2c3", + "CreatedAt": 1517442103 + } + } + +For more information, see `Working with AWS Elemental MediaConvert Jobs `_ in the *AWS Elemental MediaConvert User Guide*. diff --git a/bin/awscli/examples/mediaconvert/list-jobs.rst b/bin/awscli/examples/mediaconvert/list-jobs.rst new file mode 100644 index 00000000..139df49b --- /dev/null +++ b/bin/awscli/examples/mediaconvert/list-jobs.rst @@ -0,0 +1,11 @@ +**To get details for all jobs in a region** + +The following example requests the information for all of your jobs in the specified region. :: + + aws mediaconvert list-jobs \ + --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \ + --region region-name-1 + +To get your account-specific endpoint, use ``describe-endpoints``, or send the command without the endpoint. The service returns an error and your endpoint. + +For more information, see `Working with AWS Elemental MediaConvert Jobs `_ in the *AWS Elemental MediaConvert User Guide*. diff --git a/bin/awscli/examples/opsworks/create-deployment.rst b/bin/awscli/examples/opsworks/create-deployment.rst index b7c7ee4b..4fb916e8 100644 --- a/bin/awscli/examples/opsworks/create-deployment.rst +++ b/bin/awscli/examples/opsworks/create-deployment.rst @@ -1,69 +1,66 @@ -**To deploy apps and run stack commands** +**Example 1: To deploy apps and run stack commands** -The following examples show how to use the ``create-deployment`` command to deploy apps and run stack commands. Notice that the -quote (``"``) characters in the JSON object that specifies the command are all preceded by -escape characters (\). Without the escape characters, the command might -return an invalid JSON error. +The following examples show how to use the ``create-deployment`` command to deploy apps and run stack commands. Notice that the quote (``"``) characters in the JSON object that specifies the command are all preceded by escape characters (\\). Without the escape characters, the command might return an invalid JSON error. -**Deploy an App** +The following ``create-deployment`` example deploys an app to a specified stack. :: -The following ``create-deployment`` command deploys an app to a specified stack. :: + aws opsworks create-deployment \ + --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf \ + --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb + --command "{\"Name\":\"deploy\"}" - aws opsworks --region us-east-1 create-deployment --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb --command "{\"Name\":\"deploy\"}" +Output:: -*Output*:: + { + "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560" + } - { - "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560" - } +**Example 2: To deploy a Rails App and Migrate the Database** -**Deploy a Rails App and Migrate the Database** +The following ``create-deployment`` command deploys a Ruby on Rails app to a specified stack and migrates the database. :: -The following ``create-deployment`` command deploys a Ruby on Rails app to a specified stack and migrates the -database. :: + aws opsworks create-deployment \ + --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf \ + --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb \ + --command "{\"Name\":\"deploy\", \"Args\":{\"migrate\":[\"true\"]}}" - aws opsworks --region us-east-1 create-deployment --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb --command "{\"Name\":\"deploy\", \"Args\":{\"migrate\":[\"true\"]}}" +Output:: -*Output*:: + { + "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560" + } - { - "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560" - } +For more information on deployment, see `Deploying Apps `__ in the *AWS OpsWorks User Guide*. -For more information on deployment, see `Deploying Apps`_ in the *AWS OpsWorks User Guide*. +**Example 3: Run a Recipe** -**Execute a Recipe** +The following ``create-deployment`` command runs a custom recipe, ``phpapp::appsetup``, on the instances in a specified stack. :: -The following ``create-deployment`` command runs a custom recipe, ``phpapp::appsetup``, on the instances in a specified -stack. :: + aws opsworks create-deployment \ + --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb \ + --command "{\"Name\":\"execute_recipes\", \"Args\":{\"recipes\":[\"phpapp::appsetup\"]}}" - aws opsworks --region ap-south-1 create-deployment --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --command "{\"Name\":\"execute_recipes\", \"Args\":{\"recipes\":[\"phpapp::appsetup\"]}} +Output:: -*Output*:: + { + "DeploymentId": "5cbaa7b9-4e09-4e53-aa1b-314fbd106038" + } - { - "DeploymentId": "5cbaa7b9-4e09-4e53-aa1b-314fbd106038" - } +For more information, see `Run Stack Commands `__ in the *AWS OpsWorks User Guide*. -For more information, see `Run Stack Commands`_ in the *AWS OpsWorks User Guide*. - -**Install Dependencies** +**Example 4: Install Dependencies** The following ``create-deployment`` command installs dependencies, such as packages or Ruby gems, on the instances in a specified stack. :: - aws opsworks --region ap-south-1 create-deployment --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --command "{\"Name\":\"install_dependencies\"}" - -*Output*:: - - { - "DeploymentId": "aef5b255-8604-4928-81b3-9b0187f962ff" - } - -**More Information** + aws opsworks create-deployment \ + --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb \ + --command "{\"Name\":\"install_dependencies\"}" -For more information, see `Run Stack Commands`_ in the *AWS OpsWorks User Guide*. +Output:: -.. _`Deploying Apps`: http://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-deploying.html -.. _`Run Stack Commands`: http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-commands.html + { + "DeploymentId": "aef5b255-8604-4928-81b3-9b0187f962ff" + } +For more information, see `Run Stack Commands `__ in the *AWS OpsWorks User Guide*. diff --git a/bin/awscli/examples/opsworkscm/create-server.rst b/bin/awscli/examples/opsworkscm/create-server.rst index 62d198f4..c10fb7e9 100644 --- a/bin/awscli/examples/opsworkscm/create-server.rst +++ b/bin/awscli/examples/opsworkscm/create-server.rst @@ -1,51 +1,48 @@ **To create a server** -The following ``create-server`` command creates a new Chef Automate server -named ``automate-06`` in your default region. Note that defaults are used for -most other settings, such as number of backups to retain, and maintenance and backup -start times. Before you run a ``create-server`` command, complete prerequisites in -.. _`Getting Started with AWS OpsWorks for Chef Automate`: http://docs.aws.amazon.com/opsworks/latest/userguide/gettingstarted-opscm.html -.:: - - aws opsworks-cm create-server --engine "Chef" --engine-model "Single" --engine-version "12" --server-name "automate-06" --instance-profile-arn "arn:aws:iam::1019881987024:instance-profile/aws-opsworks-cm-ec2-role" --instance-type "t2.medium" --key-pair "amazon-test" --service-role-arn "arn:aws:iam::044726508045:role/aws-opsworks-cm-service-role" - -The output shows you information similar to the following about the new server. -*Output*:: - - { - "Server": { - "BackupRetentionCount": 10, - "CreatedAt": 2016-07-29T13:38:47.520Z, - "DisableAutomatedBackup": FALSE, - "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com", - "Engine": "Chef", - "EngineAttributes": [ - { - "Name": "CHEF_DELIVERY_ADMIN_PASSWORD", - "Value": "1Password1" - } - ], - "EngineModel": "Single", - "EngineVersion": "12", - "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/aws-opsworks-cm-ec2-role", - "InstanceType": "t2.medium", - "KeyPair": "amazon-test", - "MaintenanceStatus": "", - "PreferredBackupWindow": "Sun:02:00", - "PreferredMaintenanceWindow": "00:00", - "SecurityGroupIds": [ "sg-1a24c270" ], - "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2", - "ServerName": "automate-06", - "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role", - "Status": "CREATING", - "StatusReason": "", - "SubnetIds": [ "subnet-49436a18" ] - } -} - -**More Information** - -For more information, see `UpdateServer`_ in the *AWS OpsWorks for Chef Automate API Reference*. - -.. _`UpdateServer`: http://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_UpdateServer.html - +The following ``create-server`` example creates a new Chef Automate server named ``automate-06`` in your default region. Note that defaults are used for most other settings, such as number of backups to retain, and maintenance and backup start times. Before you run a ``create-server`` command, complete prerequisites in `Getting Started with AWS OpsWorks for Chef Automate `_ in the *AWS Opsworks for Chef Automate User Guide*. :: + + aws opsworks-cm create-server -\ + -engine "Chef" \ + --engine-model "Single" \ + --engine-version "12" \ + --server-name "automate-06" \ + --instance-profile-arn "arn:aws:iam::1019881987024:instance-profile/aws-opsworks-cm-ec2-role" \ + --instance-type "t2.medium" \ + --key-pair "amazon-test" \ + --service-role-arn "arn:aws:iam::044726508045:role/aws-opsworks-cm-service-role" + +The output shows you information similar to the following about the new server:: + + { + "Server": { + "BackupRetentionCount": 10, + "CreatedAt": 2016-07-29T13:38:47.520Z, + "DisableAutomatedBackup": FALSE, + "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com", + "Engine": "Chef", + "EngineAttributes": [ + { + "Name": "CHEF_DELIVERY_ADMIN_PASSWORD", + "Value": "1Password1" + } + ], + "EngineModel": "Single", + "EngineVersion": "12", + "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/aws-opsworks-cm-ec2-role", + "InstanceType": "t2.medium", + "KeyPair": "amazon-test", + "MaintenanceStatus": "", + "PreferredBackupWindow": "Sun:02:00", + "PreferredMaintenanceWindow": "00:00", + "SecurityGroupIds": [ "sg-1a24c270" ], + "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2", + "ServerName": "automate-06", + "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role", + "Status": "CREATING", + "StatusReason": "", + "SubnetIds": [ "subnet-49436a18" ] + } + } + +For more information, see `UpdateServer `_ in the *AWS OpsWorks for Chef Automate API Reference*. diff --git a/bin/awscli/examples/opsworkscm/describe-events.rst b/bin/awscli/examples/opsworkscm/describe-events.rst index 5caed9a7..ce105515 100644 --- a/bin/awscli/examples/opsworkscm/describe-events.rst +++ b/bin/awscli/examples/opsworkscm/describe-events.rst @@ -1,27 +1,20 @@ **To describe events** -The following ``describe-events`` command returns information about all events -that are associated with a Chef Automate server named ``automate-06``.:: +The following ``describe-events`` example returns information about all events that are associated with the specified Chef Automate server. :: - aws opsworks-cm describe-events --server-name 'automate-06' + aws opsworks-cm describe-events --server-name 'automate-06' -The output for each event entry returned by the command resembles the following. -*Output*:: +The output for each event entry returned by the command resembles the following example:: - { - "ServerEvents": [ - { - "CreatedAt": 2016-07-29T13:38:47.520Z, - "LogUrl": "https://s3.amazonaws.com/automate-06/automate-06-20160729133847520", - "Message": "Updates successfully installed.", - "ServerName": "automate-06" - } - ] -} - -**More Information** - -For more information, see `General Troubleshooting Tips`_ in the *AWS OpsWorks User Guide*. - -.. _`General Troubleshooting Tips`: http://docs.aws.amazon.com/opsworks/latest/userguide/troubleshoot-opscm.html#d0e4561 + { + "ServerEvents": [ + { + "CreatedAt": 2016-07-29T13:38:47.520Z, + "LogUrl": "https://s3.amazonaws.com/automate-06/automate-06-20160729133847520", + "Message": "Updates successfully installed.", + "ServerName": "automate-06" + } + ] + } +For more information, see `General Troubleshooting Tips `_ in the *AWS OpsWorks User Guide*. diff --git a/bin/awscli/examples/opsworkscm/start-maintenance.rst b/bin/awscli/examples/opsworkscm/start-maintenance.rst index cb35502a..8a28ee15 100644 --- a/bin/awscli/examples/opsworkscm/start-maintenance.rst +++ b/bin/awscli/examples/opsworkscm/start-maintenance.rst @@ -1,48 +1,40 @@ **To start maintenance** -The following ``start-maintenance`` command manually starts maintenance on a Chef Automate server -named ``automate-06`` in your default region. This command can be useful if an earlier, automated -maintenance attempt failed, and the underlying cause of maintenance failure has been resolved.:: - - aws opsworks-cm start-maintenance --server-name 'automate-06' - -The output shows you information similar to the following about the maintenance request. -*Output*:: - - { - "Server": { - "BackupRetentionCount": 8, - "CreatedAt": 2016-07-29T13:38:47.520Z, - "DisableAutomatedBackup": TRUE, - "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com", - "Engine": "Chef", - "EngineAttributes": [ - { - "Name": "CHEF_DELIVERY_ADMIN_PASSWORD", - "Value": "1Password1" - } - ], - "EngineModel": "Single", - "EngineVersion": "12", - "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2", - "InstanceType": "m4.large", - "KeyPair": "", - "MaintenanceStatus": "SUCCESS", - "PreferredBackupWindow": "", - "PreferredMaintenanceWindow": "", - "SecurityGroupIds": [ "sg-1a24c270" ], - "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2", - "ServerName": "automate-06", - "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735", - "Status": "HEALTHY", - "StatusReason": "", - "SubnetIds": [ "subnet-49436a18" ] - } -} - -**More Information** - -For more information, see `StartMaintenance`_ in the *AWS OpsWorks for Chef Automate API Reference*. - -.. _`StartMaintenance`: http://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_StartMaintenance.html - +The following ``start-maintenance`` example manually starts maintenance on the specified Chef Automate server in your default region. This command can be useful if an earlier, automated maintenance attempt failed, and the underlying cause of maintenance failure has been resolved. :: + + aws opsworks-cm start-maintenance --server-name 'automate-06' + +The output shows you information similar to the following about the maintenance request. :: + + { + "Server": { + "BackupRetentionCount": 8, + "CreatedAt": 2016-07-29T13:38:47.520Z, + "DisableAutomatedBackup": TRUE, + "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com", + "Engine": "Chef", + "EngineAttributes": [ + { + "Name": "CHEF_DELIVERY_ADMIN_PASSWORD", + "Value": "1Password1" + } + ], + "EngineModel": "Single", + "EngineVersion": "12", + "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2", + "InstanceType": "m4.large", + "KeyPair": "", + "MaintenanceStatus": "SUCCESS", + "PreferredBackupWindow": "", + "PreferredMaintenanceWindow": "", + "SecurityGroupIds": [ "sg-1a24c270" ], + "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2", + "ServerName": "automate-06", + "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735", + "Status": "HEALTHY", + "StatusReason": "", + "SubnetIds": [ "subnet-49436a18" ] + } + } + +For more information, see `StartMaintenance `_ in the *AWS OpsWorks for Chef Automate API Reference*. diff --git a/bin/awscli/examples/opsworkscm/update-server-engine-attributes.rst b/bin/awscli/examples/opsworkscm/update-server-engine-attributes.rst index eef842f3..814111bc 100644 --- a/bin/awscli/examples/opsworkscm/update-server-engine-attributes.rst +++ b/bin/awscli/examples/opsworkscm/update-server-engine-attributes.rst @@ -1,48 +1,43 @@ **To update server engine attributes** -The following ``update-server-engine-attributes`` command updates the value of the -``CHEF_PIVOTAL_KEY`` engine attribute for a Chef Automate server named ``automate-06``. -It is currently not possible to change the value of other engine attributes.:: - - aws opsworks-cm update-server-engine-attributes --attribute-name CHEF_PIVOTAL_KEY --attribute-value "new key value" --server-name "automate-06" - -The output shows you information similar to the following about the updated server. -*Output*:: - - { - "Server": { - "BackupRetentionCount": 2, - "CreatedAt": 2016-07-29T13:38:47.520Z, - "DisableAutomatedBackup": FALSE, - "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com", - "Engine": "Chef", - "EngineAttributes": [ - { - "Name": "CHEF_PIVOTAL_KEY", - "Value": "new key value" - } - ], - "EngineModel": "Single", - "EngineVersion": "12", - "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2", - "InstanceType": "m4.large", - "KeyPair": "", - "MaintenanceStatus": "SUCCESS", - "PreferredBackupWindow": "Mon:09:15", - "PreferredMaintenanceWindow": "03:00", - "SecurityGroupIds": [ "sg-1a24c270" ], - "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2", - "ServerName": "automate-06", - "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735", - "Status": "HEALTHY", - "StatusReason": "", - "SubnetIds": [ "subnet-49436a18" ] - } -} - -**More Information** - -For more information, see `UpdateServerEngineAttributes`_ in the *AWS OpsWorks for Chef Automate API Reference*. - -.. _`UpdateServerEngineAttributes`: http://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_UpdateServerEngineAttributes.html - +The following ``update-server-engine-attributes`` command updates the value of the ``CHEF_PIVOTAL_KEY`` engine attribute for a Chef Automate server named ``automate-06``. It is currently not possible to change the value of other engine attributes. :: + + aws opsworks-cm update-server-engine-attributes \ + --attribute-name CHEF_PIVOTAL_KEY \ + --attribute-value "new key value" \ + --server-name "automate-06" + +The output shows you information similar to the following about the updated server. :: + + { + "Server": { + "BackupRetentionCount": 2, + "CreatedAt": 2016-07-29T13:38:47.520Z, + "DisableAutomatedBackup": FALSE, + "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com", + "Engine": "Chef", + "EngineAttributes": [ + { + "Name": "CHEF_PIVOTAL_KEY", + "Value": "new key value" + } + ], + "EngineModel": "Single", + "EngineVersion": "12", + "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2", + "InstanceType": "m4.large", + "KeyPair": "", + "MaintenanceStatus": "SUCCESS", + "PreferredBackupWindow": "Mon:09:15", + "PreferredMaintenanceWindow": "03:00", + "SecurityGroupIds": [ "sg-1a24c270" ], + "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2", + "ServerName": "automate-06", + "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735", + "Status": "HEALTHY", + "StatusReason": "", + "SubnetIds": [ "subnet-49436a18" ] + } + } + +For more information, see `UpdateServerEngineAttributes `_ in the *AWS OpsWorks for Chef Automate API Reference*. diff --git a/bin/awscli/examples/opsworkscm/update-server.rst b/bin/awscli/examples/opsworkscm/update-server.rst index e1f53d7b..fd089c5c 100644 --- a/bin/awscli/examples/opsworkscm/update-server.rst +++ b/bin/awscli/examples/opsworkscm/update-server.rst @@ -1,48 +1,42 @@ **To update a server** -The following ``update-server`` command updates the maintenance start time of a Chef Automate server -named ``automate-06`` in your default region. The ``--preferred-maintenance-window`` parameter is -added to change the start day and time of server maintenance to Mondays at 9:15 a.m. UTC.:: - - aws opsworks-cm update-server --server-name "automate-06" --preferred-maintenance-window "Mon:09:15" - -The output shows you information similar to the following about the updated server. -*Output*:: - - { - "Server": { - "BackupRetentionCount": 8, - "CreatedAt": 2016-07-29T13:38:47.520Z, - "DisableAutomatedBackup": TRUE, - "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com", - "Engine": "Chef", - "EngineAttributes": [ - { - "Name": "CHEF_DELIVERY_ADMIN_PASSWORD", - "Value": "1Password1" - } - ], - "EngineModel": "Single", - "EngineVersion": "12", - "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2", - "InstanceType": "m4.large", - "KeyPair": "", - "MaintenanceStatus": "OK", - "PreferredBackupWindow": "Mon:09:15", - "PreferredMaintenanceWindow": "03:00", - "SecurityGroupIds": [ "sg-1a24c270" ], - "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2", - "ServerName": "automate-06", - "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735", - "Status": "HEALTHY", - "StatusReason": "", - "SubnetIds": [ "subnet-49436a18" ] - } -} - -**More Information** - -For more information, see `UpdateServer`_ in the *AWS OpsWorks for Chef Automate API Reference*. - -.. _`UpdateServer`: http://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_UpdateServer.html - +The following ``update-server`` command updates the maintenance start time of the specified Chef Automate server in your default region. The ``--preferred-maintenance-window`` parameter is added to change the start day and time of server maintenance to Mondays at 9:15 a.m. UTC.:: + + aws opsworks-cm update-server \ + --server-name "automate-06" \ + --preferred-maintenance-window "Mon:09:15" + +The output shows you information similar to the following about the updated server. :: + + { + "Server": { + "BackupRetentionCount": 8, + "CreatedAt": 2016-07-29T13:38:47.520Z, + "DisableAutomatedBackup": TRUE, + "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com", + "Engine": "Chef", + "EngineAttributes": [ + { + "Name": "CHEF_DELIVERY_ADMIN_PASSWORD", + "Value": "1Password1" + } + ], + "EngineModel": "Single", + "EngineVersion": "12", + "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2", + "InstanceType": "m4.large", + "KeyPair": "", + "MaintenanceStatus": "OK", + "PreferredBackupWindow": "Mon:09:15", + "PreferredMaintenanceWindow": "03:00", + "SecurityGroupIds": [ "sg-1a24c270" ], + "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2", + "ServerName": "automate-06", + "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735", + "Status": "HEALTHY", + "StatusReason": "", + "SubnetIds": [ "subnet-49436a18" ] + } + } + +For more information, see `UpdateServer `_ in the *AWS OpsWorks for Chef Automate API Reference*. diff --git a/bin/awscli/examples/organizations/remove-account-from-organization.rst b/bin/awscli/examples/organizations/remove-account-from-organization.rst index d8413f74..e785fe91 100755 --- a/bin/awscli/examples/organizations/remove-account-from-organization.rst +++ b/bin/awscli/examples/organizations/remove-account-from-organization.rst @@ -2,4 +2,4 @@ The following example shows you how to remove an account from an organization: :: - aws organizations remove-account --account-id 333333333333 \ No newline at end of file + aws organizations remove-account-from-organization --account-id 333333333333 diff --git a/bin/awscli/examples/organizations/update-policy.rst b/bin/awscli/examples/organizations/update-policy.rst index 9f53e436..ce1c3b68 100755 --- a/bin/awscli/examples/organizations/update-policy.rst +++ b/bin/awscli/examples/organizations/update-policy.rst @@ -1,43 +1,48 @@ **Example 1: To rename a policy** -The following example shows you how to rename a policy and give it a new description: :: - - aws organizations update-policy --policy-id p-examplepolicyid111 --name Renamed-Policy --description "This description replaces the original." - -The output shows the new name and description: :: - - { - "Policy": { - "Content": "{\n \"Version\":\"2012-10-17\",\n \"Statement\":{\n \"Effect\":\"Allow\",\n \"Action\":\"ec2:*\",\n \"Resource\":\"*\"\n }\n}\n", - "PolicySummary": { - "Id": "p-examplepolicyid111", - "AwsManaged": false, - "Arn":"arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111", - "Description": "This description replaces the original.", - "Name": "Renamed-Policy", - "Type": "SERVICE_CONTROL_POLICY" - } - } - } +The following ``update-policy`` example renames a policy and gives it a new description. :: + + aws organizations update-policy \ + --policy-id p-examplepolicyid111 \ + --name Renamed-Policy \ + --description "This description replaces the original." + +The output shows the new name and description. :: + + { + "Policy": { + "Content": "{\n \"Version\":\"2012-10-17\",\n \"Statement\":{\n \"Effect\":\"Allow\",\n \"Action\":\"ec2:*\",\n \"Resource\":\"*\"\n }\n}\n", + "PolicySummary": { + "Id": "p-examplepolicyid111", + "AwsManaged": false, + "Arn":"arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111", + "Description": "This description replaces the original.", + "Name": "Renamed-Policy", + "Type": "SERVICE_CONTROL_POLICY" + } + } + } **Example 2: To replace a policy's JSON text content** The following example shows you how to replace the JSON text of the SCP in the previous example with a new JSON policy text string that allows S3 instead of EC2: :: - aws organizations --policy-id p-examplepolicyid111, --content "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"s3:*\",\"Resource\":\"*\"}}" - -The output shows the new content: :: - - { - "Policy": { - "Content": "{ \"Version\": \"2012-10-17\", \"Statement\": { \"Effect\": \"Allow\", \"Action\": \"s3:*\", \"Resource\": \"*\" } }", - "PolicySummary": { - "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111", - "AwsManaged": false; - "Description": "This description replaces the original.", - "Id": "p-examplepolicyid111", - "Name": "Renamed-Policy", - "Type": "SERVICE_CONTROL_POLICY" - } - } - } \ No newline at end of file + aws organizations update-policy \ + --policy-id p-examplepolicyid111 \ + --content "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"s3:*\",\"Resource\":\"*\"}}" + +The output shows the new content:: + + { + "Policy": { + "Content": "{ \"Version\": \"2012-10-17\", \"Statement\": { \"Effect\": \"Allow\", \"Action\": \"s3:*\", \"Resource\": \"*\" } }", + "PolicySummary": { + "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111", + "AwsManaged": false; + "Description": "This description replaces the original.", + "Id": "p-examplepolicyid111", + "Name": "Renamed-Policy", + "Type": "SERVICE_CONTROL_POLICY" + } + } + } diff --git a/bin/awscli/examples/pricing/describe-services.rst b/bin/awscli/examples/pricing/describe-services.rst new file mode 100644 index 00000000..c21e3124 --- /dev/null +++ b/bin/awscli/examples/pricing/describe-services.rst @@ -0,0 +1,82 @@ +**To retrieve service metadata** + +This example retrieves the metadata for the Amazon EC2 service code. + +Command:: + + aws pricing describe-services --service-code AmazonEC2 --format-version aws_v1 --max-items 1 + +Output:: + + { + "Services": [ + { + "ServiceCode": "AmazonEC2", + "AttributeNames": [ + "volumeType", + "maxIopsvolume", + "instance", + "instanceCapacity10xlarge", + "locationType", + "instanceFamily", + "operatingSystem", + "clockSpeed", + "LeaseContractLength", + "ecu", + "networkPerformance", + "instanceCapacity8xlarge", + "group", + "maxThroughputvolume", + "gpuMemory", + "ebsOptimized", + "elasticGpuType", + "maxVolumeSize", + "gpu", + "processorFeatures", + "intelAvxAvailable", + "instanceCapacity4xlarge", + "servicecode", + "groupDescription", + "processorArchitecture", + "physicalCores", + "productFamily", + "enhancedNetworkingSupported", + "intelTurboAvailable", + "memory", + "dedicatedEbsThroughput", + "vcpu", + "OfferingClass", + "instanceCapacityLarge", + "capacitystatus", + "termType", + "storage", + "intelAvx2Available", + "storageMedia", + "physicalProcessor", + "provisioned", + "servicename", + "PurchaseOption", + "instanceCapacity18xlarge", + "instanceType", + "tenancy", + "usagetype", + "normalizationSizeFactor", + "instanceCapacity2xlarge", + "instanceCapacity16xlarge", + "maxIopsBurstPerformance", + "instanceCapacity12xlarge", + "instanceCapacity32xlarge", + "instanceCapacityXlarge", + "licenseModel", + "currentGeneration", + "preInstalledSw", + "location", + "instanceCapacity24xlarge", + "instanceCapacity9xlarge", + "instanceCapacityMedium", + "operation" + ] + } + ], + "FormatVersion": "aws_v1" + } diff --git a/bin/awscli/examples/pricing/get-attribute-values.rst b/bin/awscli/examples/pricing/get-attribute-values.rst new file mode 100644 index 00000000..339767af --- /dev/null +++ b/bin/awscli/examples/pricing/get-attribute-values.rst @@ -0,0 +1,22 @@ +**To retrieve a list of attribute values** + +The following ``get-attribute-values`` example retrieves a list of values available for the given attribute. :: + + aws pricing get-attribute-values \ + --service-code AmazonEC2 \ + --attribute-name volumeType \ + --max-items 2 + +Output:: + + { + "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ==", + "AttributeValues": [ + { + "Value": "Cold HDD" + }, + { + "Value": "General Purpose" + } + ] + } diff --git a/bin/awscli/examples/pricing/get-products.rst b/bin/awscli/examples/pricing/get-products.rst new file mode 100644 index 00000000..34eba01b --- /dev/null +++ b/bin/awscli/examples/pricing/get-products.rst @@ -0,0 +1,32 @@ +**To retrieve a list of products** + +This example retrieves a list of products that match the given criteria. + +Command:: + + aws pricing get-products --filters file://filters.json --format-version aws_v1 --max-results 1 --service-code AmazonEC2 + +filters.json:: + + [ + { + "Type": "TERM_MATCH", + "Field": "ServiceCode", + "Value": "AmazonEC2" + }, + { + "Type": "TERM_MATCH", + "Field": "volumeType", + "Value": "Provisioned IOPS" + } + ] + +Output:: + + { + "FormatVersion": "aws_v1", + "NextToken": "WGDY7ko8fQXdlaUZVdasFQ==:RVSagyIFn770XQOzdUIcO9BY6ucBG9itXAZGZF/zioUzOsUKh6PCcPWaOyPZRiMePb986TeoKYB9l55fw/CyoMq5ymnGmT1Vj39TljbbAlhcqnVfTmPIilx8Uy5bdDaBYy/e/2Ofw9Edzsykbs8LTBuNbiDQ+BBds5yeI9AQkUepruKk3aEahFPxJ55kx/zk", + "PriceList": [ + "{\"product\":{\"productFamily\":\"Storage\",\"attributes\":{\"storageMedia\":\"SSD-backed\",\"maxThroughputvolume\":\"320 MB/sec\",\"volumeType\":\"Provisioned IOPS\",\"maxIopsvolume\":\"20000\",\"servicecode\":\"AmazonEC2\",\"usagetype\":\"APS1-EBS:VolumeUsage.piops\",\"locationType\":\"AWS Region\",\"location\":\"Asia Pacific (Singapore)\",\"servicename\":\"Amazon Elastic Compute Cloud\",\"maxVolumeSize\":\"16 TiB\",\"operation\":\"\"},\"sku\":\"3MKHN58N7RDDVGKJ\"},\"serviceCode\":\"AmazonEC2\",\"terms\":{\"OnDemand\":{\"3MKHN58N7RDDVGKJ.JRTCKXETXF\":{\"priceDimensions\":{\"3MKHN58N7RDDVGKJ.JRTCKXETXF.6YS6EN2CT7\":{\"unit\":\"GB-Mo\",\"endRange\":\"Inf\",\"description\":\"$0.138 per GB-month of Provisioned IOPS SSD (io1) provisioned storage - Asia Pacific (Singapore)\",\"appliesTo\":[],\"rateCode\":\"3MKHN58N7RDDVGKJ.JRTCKXETXF.6YS6EN2CT7\",\"beginRange\":\"0\",\"pricePerUnit\":{\"USD\":\"0.1380000000\"}}},\"sku\":\"3MKHN58N7RDDVGKJ\",\"effectiveDate\":\"2018-08-01T00:00:00Z\",\"offerTermCode\":\"JRTCKXETXF\",\"termAttributes\":{}}}},\"version\":\"20180808005701\",\"publicationDate\":\"2018-08-08T00:57:01Z\"}" + ] + } diff --git a/bin/awscli/examples/rds/add-option-to-option-group.rst b/bin/awscli/examples/rds/add-option-to-option-group.rst new file mode 100644 index 00000000..4198a217 --- /dev/null +++ b/bin/awscli/examples/rds/add-option-to-option-group.rst @@ -0,0 +1,61 @@ +**To add an option to an option group** + +The following ``add-option-to-option-group`` example adds an option to the specified option group. :: + + aws rds add-option-to-option-group \ + --option-group-name myoptiongroup \ + --options OptionName=OEM,Port=5500,DBSecurityGroupMemberships=default \ + --apply-immediately + +Output:: + + { + "OptionGroup": { + "OptionGroupName": "myoptiongroup", + "OptionGroupDescription": "Test Option Group", + "EngineName": "oracle-ee", + "MajorEngineVersion": "12.1", + "Options": [ + { + "OptionName": "Timezone", + "OptionDescription": "Change time zone", + "Persistent": true, + "Permanent": false, + "OptionSettings": [ + { + "Name": "TIME_ZONE", + "Value": "Australia/Sydney", + "DefaultValue": "UTC", + "Description": "Specifies the timezone the user wants to change the system time to", + "ApplyType": "DYNAMIC", + "DataType": "STRING", + "AllowedValues": "Africa/Cairo,Africa/Casablanca,Africa/Harare,Africa/Lagos,Africa/Luanda,Africa/Monrovia,Africa/Nairobi,Africa/Tripoli,Africa/Windhoek,America/Araguaina,America/Argentina/Buenos_Aires,America/Asuncion,America/Bogota,America/Caracas,America/Chicago,America/Chihuahua,America/Cuiaba,America/Denver,America/Detroit,America/Fortaleza,America/Godthab,America/Guatemala,America/Halifax,America/Lima,America/Los_Angeles,America/Manaus,America/Matamoros,America/Mexico_City,America/Monterrey,America/Montevideo,America/New_York,America/Phoenix,America/Santiago,America/Sao_Paulo,America/Tijuana,America/Toronto,Asia/Amman,Asia/Ashgabat,Asia/Baghdad,Asia/Baku,Asia/Bangkok,Asia/Beirut,Asia/Calcutta,Asia/Damascus,Asia/Dhaka,Asia/Hong_Kong,Asia/Irkutsk,Asia/Jakarta,Asia/Jerusalem,Asia/Kabul,Asia/Karachi,Asia/Kathmandu,Asia/Kolkata,Asia/Krasnoyarsk,Asia/Magadan,Asia/Manila,Asia/Muscat,Asia/Novosibirsk,Asia/Rangoon,Asia/Riyadh,Asia/Seoul,Asia/Shanghai,Asia/Singapore,Asia/Taipei,Asia/Tehran,Asia/Tokyo,Asia/Ulaanbaatar,Asia/Vladivostok,Asia/Yakutsk,Asia/Yerevan,Atlantic/Azores,Atlantic/Cape_Verde,Australia/Adelaide,Australia/Brisbane,Australia/Darwin,Australia/Eucla,Australia/Hobart,Australia/Lord_Howe,Australia/Perth,Australia/Sydney,Brazil/DeNoronha,Brazil/East,Canada/Newfoundland,Canada/Saskatchewan,Etc/GMT-3,Europe/Amsterdam,Europe/Athens,Europe/Berlin,Europe/Dublin,Europe/Helsinki,Europe/Kaliningrad,Europe/London,Europe/Madrid,Europe/Moscow,Europe/Paris,Europe/Prague,Europe/Rome,Europe/Sarajevo,Pacific/Apia,Pacific/Auckland,Pacific/Chatham,Pacific/Fiji,Pacific/Guam,Pacific/Honolulu,Pacific/Kiritimati,Pacific/Marquesas,Pacific/Samoa,Pacific/Tongatapu,Pacific/Wake,US/Alaska,US/Central,US/East-Indiana,US/Eastern,US/Pacific,UTC", + "IsModifiable": true, + "IsCollection": false + } + ], + "DBSecurityGroupMemberships": [], + "VpcSecurityGroupMemberships": [] + }, + { + "OptionName": "OEM", + "OptionDescription": "Oracle 12c EM Express", + "Persistent": false, + "Permanent": false, + "Port": 5500, + "OptionSettings": [], + "DBSecurityGroupMemberships": [ + { + "DBSecurityGroupName": "default", + "Status": "authorized" + } + ], + "VpcSecurityGroupMemberships": [] + } + ], + "AllowsVpcAndNonVpcInstanceMemberships": false, + "OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:myoptiongroup" + } + } + +For more information, see `Adding an Option to an Option Group `__ in the *Amazon RDS User Guide*. diff --git a/bin/awscli/examples/rds/add-source-identifier-to-subscription.rst b/bin/awscli/examples/rds/add-source-identifier-to-subscription.rst index bdee9344..28615aa6 100644 --- a/bin/awscli/examples/rds/add-source-identifier-to-subscription.rst +++ b/bin/awscli/examples/rds/add-source-identifier-to-subscription.rst @@ -1,30 +1,30 @@ **To add a source identifier to a subscription** -This example adds another source identifier to an existing subscription:: +The following ``add-source-identifier`` example adds another source identifier to an existing subscription. :: aws rds add-source-identifier-to-subscription \ - --subscription-name my-instance-events \ - --source-identifier test-instance-repl + --subscription-name my-instance-events \ + --source-identifier test-instance-repl Output:: -{ - "EventSubscription": { - "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", - "CustSubscriptionId": "my-instance-events", - "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", - "Enabled": false, - "Status": "modifying", - "EventCategoriesList": [ - "backup", - "recovery" - ], - "CustomerAwsId": "123456789012", - "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", - "SourceType": "db-instance", - "SourceIdsList": [ - "test-instance", - "test-instance-repl" - ] + { + "EventSubscription": { + "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", + "CustSubscriptionId": "my-instance-events", + "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", + "Enabled": false, + "Status": "modifying", + "EventCategoriesList": [ + "backup", + "recovery" + ], + "CustomerAwsId": "123456789012", + "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", + "SourceType": "db-instance", + "SourceIdsList": [ + "test-instance", + "test-instance-repl" + ] + } } -} diff --git a/bin/awscli/examples/rds/add-tags-to-resource.rst b/bin/awscli/examples/rds/add-tags-to-resource.rst new file mode 100644 index 00000000..ad11238b --- /dev/null +++ b/bin/awscli/examples/rds/add-tags-to-resource.rst @@ -0,0 +1,11 @@ +**To add tags to a resource** + +The following ``add-tags-to-resource`` example add tags to an RDS database. :: + + aws rds add-tags-to-resource \ + --resource-name arn:aws:rds:us-east-1:123456789012:db:database-mysql \ + --tags "[{\"Key\": \"Name\",\"Value\": \"MyDatabase\"},{\"Key\": \"Environment\",\"Value\": \"test\"}]" + +This command produces no output. + +For more information, see `Tagging Amazon RDS Resources `__ in the *Amazon RDS User Guide*. diff --git a/bin/awscli/examples/rds/backtrack-db-cluster.rst b/bin/awscli/examples/rds/backtrack-db-cluster.rst new file mode 100644 index 00000000..318df0af --- /dev/null +++ b/bin/awscli/examples/rds/backtrack-db-cluster.rst @@ -0,0 +1,7 @@ +**To backtrack an Aurora DB cluster** + +The following ``backtrack-db-cluster`` example backtracks the specified DB cluster sample-cluster to March 19, 2018, at 10 a.m. :: + + aws rds backtrack-db-cluster --db-cluster-identifier sample-cluster --backtrack-to 2018-03-19T10:00:00+00:00 + +This command outputs a JSON block that acknowledges the change to the RDS resource. diff --git a/bin/awscli/examples/rds/copy-db-cluster-parameter-group.rst b/bin/awscli/examples/rds/copy-db-cluster-parameter-group.rst new file mode 100644 index 00000000..c54c5cbd --- /dev/null +++ b/bin/awscli/examples/rds/copy-db-cluster-parameter-group.rst @@ -0,0 +1,21 @@ +**To copy a DB cluster parameter group** + +The following ``copy-db-cluster-parameter-group`` example makes a copy of a DB cluster parameter group. :: + + aws rds copy-db-cluster-parameter-group \ + --source-db-cluster-parameter-group-identifier mydbclusterpg \ + --target-db-cluster-parameter-group-identifier mydbclusterpgcopy \ + --target-db-cluster-parameter-group-description "Copy of mydbclusterpg parameter group" + +Output:: + + { + "DBClusterParameterGroup": { + "DBClusterParameterGroupName": "mydbclusterpgcopy", + "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpgcopy", + "DBParameterGroupFamily": "aurora-mysql5.7", + "Description": "Copy of mydbclusterpg parameter group" + } + } + +For more information, see `Copying a DB Cluster Parameter Group `__ in the *Amazon Aurora Users Guide*. diff --git a/bin/awscli/examples/rds/copy-db-cluster-snapshot.rst b/bin/awscli/examples/rds/copy-db-cluster-snapshot.rst new file mode 100644 index 00000000..74d45eb6 --- /dev/null +++ b/bin/awscli/examples/rds/copy-db-cluster-snapshot.rst @@ -0,0 +1,40 @@ +**To copy a DB cluster snapshot** + +The following ``copy-db-cluster-snapshot`` example creates a copy of a DB cluster snapshot, including its tags. :: + + aws rds copy-db-cluster-snapshot \ + --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:myaurora-2019-06-04-09-16 + --target-db-cluster-snapshot-identifier myclustersnapshotcopy \ + --copy-tags + +Output:: + + { + "DBClusterSnapshot": { + "AvailabilityZones": [ + "us-east-1a", + "us-east-1b", + "us-east-1e" + ], + "DBClusterSnapshotIdentifier": "myclustersnapshotcopy", + "DBClusterIdentifier": "myaurora", + "SnapshotCreateTime": "2019-06-04T09:16:42.649Z", + "Engine": "aurora-mysql", + "AllocatedStorage": 0, + "Status": "available", + "Port": 0, + "VpcId": "vpc-6594f31c", + "ClusterCreateTime": "2019-04-15T14:18:42.785Z", + "MasterUsername": "myadmin", + "EngineVersion": "5.7.mysql_aurora.2.04.2", + "LicenseModel": "aurora-mysql", + "SnapshotType": "manual", + "PercentProgress": 100, + "StorageEncrypted": true, + "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE", + "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:myclustersnapshotcopy", + "IAMDatabaseAuthenticationEnabled": false + } + } + +For more information, see `Copying a Snapshot `__ in the *Amazon Aurora User Guide*. diff --git a/bin/awscli/examples/rds/copy-db-parameter-group.rst b/bin/awscli/examples/rds/copy-db-parameter-group.rst new file mode 100644 index 00000000..5a6aa891 --- /dev/null +++ b/bin/awscli/examples/rds/copy-db-parameter-group.rst @@ -0,0 +1,21 @@ +**To copy a DB cluster parameter group** + +The following ``copy-db-parameter-group`` example makes a copy of a DB parameter group. :: + + aws rds copy-db-parameter-group \ + --source-db-parameter-group-identifier mydbpg \ + --target-db-parameter-group-identifier mydbpgcopy \ + --target-db-parameter-group-description "Copy of mydbpg parameter group" + +Output:: + + { + "DBParameterGroup": { + "DBParameterGroupName": "mydbpgcopy", + "DBParameterGroupArn": "arn:aws:rds:us-east-1:814387698303:pg:mydbpgcopy", + "DBParameterGroupFamily": "mysql5.7", + "Description": "Copy of mydbpg parameter group" + } + } + +For more information, see `Copying a DB Parameter Group `__ in the *Amazon RDS Users Guide*. diff --git a/bin/awscli/examples/rds/copy-db-snapshot.rst b/bin/awscli/examples/rds/copy-db-snapshot.rst new file mode 100644 index 00000000..bc48c3b0 --- /dev/null +++ b/bin/awscli/examples/rds/copy-db-snapshot.rst @@ -0,0 +1,42 @@ +**To copy a DB snapshot** + +The following ``copy-db-snapshot`` example creates a copy of a DB snapshot. :: + + aws rds copy-db-snapshot \ + --source-db-snapshot-identifier rds:database-mysql-2019-06-06-08-38 + --target-db-snapshot-identifier mydbsnapshotcopy + +Output:: + + { + "DBSnapshot": { + "VpcId": "vpc-6594f31c", + "Status": "creating", + "Encrypted": true, + "SourceDBSnapshotIdentifier": "arn:aws:rds:us-east-1:123456789012:snapshot:rds:database-mysql-2019-06-06-08-38", + "MasterUsername": "admin", + "Iops": 1000, + "Port": 3306, + "LicenseModel": "general-public-license", + "DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshotcopy", + "EngineVersion": "5.6.40", + "OptionGroupName": "default:mysql-5-6", + "ProcessorFeatures": [], + "Engine": "mysql", + "StorageType": "io1", + "DbiResourceId": "db-ZI7UJ5BLKMBYFGX7FDENCKADC4", + "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE", + "SnapshotType": "manual", + "IAMDatabaseAuthenticationEnabled": false, + "SourceRegion": "us-east-1", + "DBInstanceIdentifier": "database-mysql", + "InstanceCreateTime": "2019-04-30T15:45:53.663Z", + "AvailabilityZone": "us-east-1f", + "PercentProgress": 0, + "AllocatedStorage": 100, + "DBSnapshotIdentifier": "mydbsnapshotcopy" + } + } + + +For more information, see `Copying a Snapshot `__ in the *Amazon RDS User Guide*. diff --git a/bin/awscli/examples/rds/copy-option-group.rst b/bin/awscli/examples/rds/copy-option-group.rst new file mode 100644 index 00000000..f3923a4d --- /dev/null +++ b/bin/awscli/examples/rds/copy-option-group.rst @@ -0,0 +1,24 @@ +**To copy an option group** + +The following ``copy-option-group`` example makes a copy of an option group. :: + + aws rds copy-option-group \ + --source-option-group-identifier myoptiongroup \ + --target-option-group-identifier new-option-group \ + --target-option-group-description "My option group copy" + +Output:: + + { + "OptionGroup": { + "Options": [], + "OptionGroupName": "new-option-group", + "MajorEngineVersion": "11.2", + "OptionGroupDescription": "My option group copy", + "AllowsVpcAndNonVpcInstanceMemberships": true, + "EngineName": "oracle-ee", + "OptionGroupArn": "arn:aws:rds:us-east-1:123456789012:og:new-option-group" + } + } + +For more information, see `Making a Copy of an Option Group `__ in the *Amazon RDS User Guide*. diff --git a/bin/awscli/examples/rds/create-db-cluster.rst b/bin/awscli/examples/rds/create-db-cluster.rst new file mode 100644 index 00000000..2efda638 --- /dev/null +++ b/bin/awscli/examples/rds/create-db-cluster.rst @@ -0,0 +1,118 @@ +**Example 1: To create a MySQL 5.7--compatible DB cluster** + +The following ``create-db-cluster`` example create a MySQL 5.7-compatible DB cluster. Replace the sample password ``secret99`` with a secure password. The writer DB instance is the first instance that is created in a DB cluster. When you use the console to create a DB cluster, Amazon RDS automatically creates the writer DB instance for your DB cluster. However, when you use the AWS CLI to create a DB cluster, you must explicitly create the writer DB instance for your DB cluster using the ``create-db-instance`` AWS CLI command. :: + + aws rds create-db-cluster \ + --db-cluster-identifier sample-cluster \ + --engine aurora-mysql \ + --engine-version 5.7.12 \ + --master-username master \ + --master-user-password secret99 \ + --db-subnet-group-name default \ + --vpc-security-group-ids sg-0b9130572daf3dc16 + +Output:: + + { + "DBCluster": { + "DBSubnetGroup": "default", + "VpcSecurityGroups": [ + { + "VpcSecurityGroupId": "sg-0b9130572daf3dc16", + "Status": "active" + } + ], + "AllocatedStorage": 1, + "AssociatedRoles": [], + "PreferredBackupWindow": "09:12-09:42", + "ClusterCreateTime": "2019-06-07T23:21:33.048Z", + "DeletionProtection": false, + "IAMDatabaseAuthenticationEnabled": false, + "ReadReplicaIdentifiers": [], + "EngineMode": "provisioned", + "Engine": "aurora-mysql", + "StorageEncrypted": false, + "MultiAZ": false, + "PreferredMaintenanceWindow": "mon:04:31-mon:05:01", + "HttpEndpointEnabled": false, + "BackupRetentionPeriod": 1, + "DbClusterResourceId": "cluster-ANPAJ4AE5446DAEXAMPLE", + "DBClusterIdentifier": "sample-cluster", + "AvailabilityZones": [ + "us-east-1a", + "us-east-1b", + "us-east-1e" + ], + "MasterUsername": "master", + "EngineVersion": "5.7.12", + "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", + "DBClusterMembers": [], + "Port": 3306, + "Status": "creating", + "Endpoint": "sample-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com", + "DBClusterParameterGroup": "default.aurora-mysql5.7", + "HostedZoneId": "Z2R2ITUGPM61AM", + "ReaderEndpoint": "sample-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com", + "CopyTagsToSnapshot": false + } + } + +**Example 2: To create a PostgreSQL--compatible DB cluster** + +The following ``create-db-cluster`` example creates a PostgreSQL-compatible DB cluster. Replace the example password ``secret99`` with a secure password. The writer DB instance is the first instance that is created in a DB cluster. When you use the console to create a DB cluster, Amazon RDS automatically creates the writer DB instance for your DB cluster. However, when you use the AWS CLI to create a DB cluster, you must explicitly create the writer DB instance for your DB cluster using the ``create-db-instance`` AWS CLI command. :: + + aws rds create-db-cluster \ + --db-cluster-identifier sample-pg-cluster \ + --engine aurora-postgresql \ + --master-username master \ + --master-user-password secret99 \ + --db-subnet-group-name default \ + --vpc-security-group-ids sg-0b9130572daf3dc16 + +Output:: + + { + "DBCluster": { + "Endpoint": "sample-pg-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com", + "HttpEndpointEnabled": false, + "DBClusterMembers": [], + "EngineMode": "provisioned", + "CopyTagsToSnapshot": false, + "HostedZoneId": "Z2R2ITUGPM61AM", + "IAMDatabaseAuthenticationEnabled": false, + "AllocatedStorage": 1, + "VpcSecurityGroups": [ + { + "VpcSecurityGroupId": "sg-0b9130572daf3dc16", + "Status": "active" + } + ], + "DeletionProtection": false, + "StorageEncrypted": false, + "BackupRetentionPeriod": 1, + "PreferredBackupWindow": "09:56-10:26", + "ClusterCreateTime": "2019-06-07T23:26:08.371Z", + "DBClusterParameterGroup": "default.aurora-postgresql9.6", + "EngineVersion": "9.6.9", + "Engine": "aurora-postgresql", + "Status": "creating", + "DBClusterIdentifier": "sample-pg-cluster", + "MultiAZ": false, + "Port": 5432, + "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-pg-cluster", + "AssociatedRoles": [], + "DbClusterResourceId": "cluster-ANPAJ4AE5446DAEXAMPLE", + "PreferredMaintenanceWindow": "wed:03:33-wed:04:03", + "ReaderEndpoint": "sample-pg-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com", + "MasterUsername": "master", + "AvailabilityZones": [ + "us-east-1a", + "us-east-1b", + "us-east-1c" + ], + "ReadReplicaIdentifiers": [], + "DBSubnetGroup": "default" + } + } + +For more information, see `Creating an Amazon Aurora DB Cluster `__ in the *Amazon Aurora Users Guide*. diff --git a/bin/awscli/examples/rds/create-db-instance-read-replica.rst b/bin/awscli/examples/rds/create-db-instance-read-replica.rst index 97f53f3d..0f3405e1 100644 --- a/bin/awscli/examples/rds/create-db-instance-read-replica.rst +++ b/bin/awscli/examples/rds/create-db-instance-read-replica.rst @@ -1,25 +1,20 @@ **To create a DB instance read replica** -This example creates a read replica of an existing DB instance (*test-instance*). The read replica is named *test-instance-repl*:: +This example creates a read replica of an existing DB instance named ``test-instance``. The read replica is named ``test-instance-repl``. :: aws rds create-db-instance-read-replica \ - --db-instance-identifier test-instance-repl \ - --source-db-instance-identifier test-instance + --db-instance-identifier test-instance-repl \ + --source-db-instance-identifier test-instance Output:: -{ - "DBInstance": { - "IAMDatabaseAuthenticationEnabled": false, - "MonitoringInterval": 0, - "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl", - "ReadReplicaSourceDBInstanceIdentifier": "test-instance", - -<...output omitted...> - - "DBInstanceIdentifier": "test-instance-repl", - -<...output omitted...> - -} - + { + "DBInstance": { + "IAMDatabaseAuthenticationEnabled": false, + "MonitoringInterval": 0, + "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl", + "ReadReplicaSourceDBInstanceIdentifier": "test-instance", + "DBInstanceIdentifier": "test-instance-repl", + ...some output truncated... + } + } diff --git a/bin/awscli/examples/rds/create-db-instance.rst b/bin/awscli/examples/rds/create-db-instance.rst index 0acf8a1e..49112a5c 100644 --- a/bin/awscli/examples/rds/create-db-instance.rst +++ b/bin/awscli/examples/rds/create-db-instance.rst @@ -1,123 +1,124 @@ **To create a DB instance** -This example launches a new DB instance:: +The following ``create-db-instance`` example launches a new DB instance. :: aws rds create-db-instance \ - --allocated-storage 20 --db-instance-class db.m1.small \ - --db-instance-identifier test-instance --engine mysql \ - --enable-cloudwatch-logs-exports '["audit","error","general","slowquery"]' \ - --master-username master --master-user-password secret99 + --allocated-storage 20 --db-instance-class db.m1.small \ + --db-instance-identifier test-instance \ + --engine mysql \ + --enable-cloudwatch-logs-exports '["audit","error","general","slowquery"]' \ + --master-username master \ + --master-user-password secret99 Output:: -{ - "DBInstance": { - "DBInstanceIdentifier": "test-instance", - "DBInstanceClass": "db.m1.small", - "Engine": "mysql", - "DBInstanceStatus": "creating", - "MasterUsername": "master", - "AllocatedStorage": 20, - "PreferredBackupWindow": "10:27-10:57", - "BackupRetentionPeriod": 1, - "DBSecurityGroups": [], - "VpcSecurityGroups": [ - { - "VpcSecurityGroupId": "sg-f839b688", - "Status": "active" - } - ], - "DBParameterGroups": [ - { - "DBParameterGroupName": "default.mysql5.6", - "ParameterApplyStatus": "in-sync" - } - ], - "DBSubnetGroup": { - "DBSubnetGroupName": "default", - "DBSubnetGroupDescription": "default", - "VpcId": "vpc-136a4c6a", - "SubnetGroupStatus": "Complete", - "Subnets": [ + { + "DBInstance": { + "DBInstanceIdentifier": "test-instance", + "DBInstanceClass": "db.m1.small", + "Engine": "mysql", + "DBInstanceStatus": "creating", + "MasterUsername": "master", + "AllocatedStorage": 20, + "PreferredBackupWindow": "10:27-10:57", + "BackupRetentionPeriod": 1, + "DBSecurityGroups": [], + "VpcSecurityGroups": [ { - "SubnetIdentifier": "subnet-cbfff283", - "SubnetAvailabilityZone": { - "Name": "us-east-1b" - }, - "SubnetStatus": "Active" - }, + "VpcSecurityGroupId": "sg-f839b688", + "Status": "active" + } + ], + "DBParameterGroups": [ { - "SubnetIdentifier": "subnet-d7c825e8", - "SubnetAvailabilityZone": { - "Name": "us-east-1e" + "DBParameterGroupName": "default.mysql5.6", + "ParameterApplyStatus": "in-sync" + } + ], + "DBSubnetGroup": { + "DBSubnetGroupName": "default", + "DBSubnetGroupDescription": "default", + "VpcId": "vpc-136a4c6a", + "SubnetGroupStatus": "Complete", + "Subnets": [ + { + "SubnetIdentifier": "subnet-cbfff283", + "SubnetAvailabilityZone": { + "Name": "us-east-1b" + }, + "SubnetStatus": "Active" }, - "SubnetStatus": "Active" - }, - { - "SubnetIdentifier": "subnet-6746046b", - "SubnetAvailabilityZone": { - "Name": "us-east-1f" + { + "SubnetIdentifier": "subnet-d7c825e8", + "SubnetAvailabilityZone": { + "Name": "us-east-1e" + }, + "SubnetStatus": "Active" }, - "SubnetStatus": "Active" - }, - { - "SubnetIdentifier": "subnet-bac383e0", - "SubnetAvailabilityZone": { - "Name": "us-east-1c" + { + "SubnetIdentifier": "subnet-6746046b", + "SubnetAvailabilityZone": { + "Name": "us-east-1f" + }, + "SubnetStatus": "Active" }, - "SubnetStatus": "Active" - }, - { - "SubnetIdentifier": "subnet-42599426", - "SubnetAvailabilityZone": { - "Name": "us-east-1d" + { + "SubnetIdentifier": "subnet-bac383e0", + "SubnetAvailabilityZone": { + "Name": "us-east-1c" + }, + "SubnetStatus": "Active" }, - "SubnetStatus": "Active" - }, - { - "SubnetIdentifier": "subnet-da327bf6", - "SubnetAvailabilityZone": { - "Name": "us-east-1a" + { + "SubnetIdentifier": "subnet-42599426", + "SubnetAvailabilityZone": { + "Name": "us-east-1d" + }, + "SubnetStatus": "Active" }, - "SubnetStatus": "Active" - } - ] - }, - "PreferredMaintenanceWindow": "sat:05:47-sat:06:17", - "PendingModifiedValues": { - "MasterUserPassword": "****", - "PendingCloudwatchLogsExports": { - "LogTypesToEnable": [ - "audit", - "error", - "general", - "slowquery" + { + "SubnetIdentifier": "subnet-da327bf6", + "SubnetAvailabilityZone": { + "Name": "us-east-1a" + }, + "SubnetStatus": "Active" + } ] - } - }, - "MultiAZ": false, - "EngineVersion": "5.6.39", - "AutoMinorVersionUpgrade": true, - "ReadReplicaDBInstanceIdentifiers": [], - "LicenseModel": "general-public-license", - "OptionGroupMemberships": [ - { - "OptionGroupName": "default:mysql-5-6", - "Status": "in-sync" - } - ], - "PubliclyAccessible": true, - "StorageType": "standard", - "DbInstancePort": 0, - "StorageEncrypted": false, - "DbiResourceId": "db-ETDZIIXHEWY5N7GXVC4SH7H5IA", - "CACertificateIdentifier": "rds-ca-2015", - "DomainMemberships": [], - "CopyTagsToSnapshot": false, - "MonitoringInterval": 0, - "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance", - "IAMDatabaseAuthenticationEnabled": false, - "PerformanceInsightsEnabled": false + }, + "PreferredMaintenanceWindow": "sat:05:47-sat:06:17", + "PendingModifiedValues": { + "MasterUserPassword": "****", + "PendingCloudwatchLogsExports": { + "LogTypesToEnable": [ + "audit", + "error", + "general", + "slowquery" + ] + } + }, + "MultiAZ": false, + "EngineVersion": "5.6.39", + "AutoMinorVersionUpgrade": true, + "ReadReplicaDBInstanceIdentifiers": [], + "LicenseModel": "general-public-license", + "OptionGroupMemberships": [ + { + "OptionGroupName": "default:mysql-5-6", + "Status": "in-sync" + } + ], + "PubliclyAccessible": true, + "StorageType": "standard", + "DbInstancePort": 0, + "StorageEncrypted": false, + "DbiResourceId": "db-ETDZIIXHEWY5N7GXVC4SH7H5IA", + "CACertificateIdentifier": "rds-ca-2015", + "DomainMemberships": [], + "CopyTagsToSnapshot": false, + "MonitoringInterval": 0, + "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance", + "IAMDatabaseAuthenticationEnabled": false, + "PerformanceInsightsEnabled": false + } } -} - diff --git a/bin/awscli/examples/rds/create-db-security-group.rst b/bin/awscli/examples/rds/create-db-security-group.rst index 5776acf6..999eb84c 100644 --- a/bin/awscli/examples/rds/create-db-security-group.rst +++ b/bin/awscli/examples/rds/create-db-security-group.rst @@ -6,9 +6,16 @@ The following ``create-db-security-group`` command creates a new Amazon RDS DB s In the example, the new DB security group is named ``mysecgroup`` and has a description. -This command output a JSON block that contains information about the DB security group. - -For more information, see `Create an Amazon RDS DB Security Group`_ in the *AWS Command Line Interface User Guide*. - -.. _`Create an Amazon RDS DB Security Group`: http://docs.aws.amazon.com/cli/latest/userguide/cli-rds-create-secgroup.html +Output:: + { + "DBSecurityGroup": { + "OwnerId": "123456789012", + "DBSecurityGroupName": "mysecgroup", + "DBSecurityGroupDescription": "My Test Security Group", + "VpcId": "vpc-a1b2c3d4", + "EC2SecurityGroups": [], + "IPRanges": [], + "DBSecurityGroupArn": "arn:aws:rds:us-west-2:123456789012:secgrp:mysecgroup" + } + } diff --git a/bin/awscli/examples/rds/create-event-subscription.rst b/bin/awscli/examples/rds/create-event-subscription.rst index 6e83bee4..81dec8a9 100644 --- a/bin/awscli/examples/rds/create-event-subscription.rst +++ b/bin/awscli/examples/rds/create-event-subscription.rst @@ -1,28 +1,28 @@ **To create an event subscription** -This example creates an event subscription for backup and recovery events for DB instances in the current AWS account. Notifications are sent to an Amazon Simple Notification Service topic, specified by *--sns-topic-arn*:: +The following ``create-event-subscription`` example creates a subscription for backup and recovery events for DB instances in the current AWS account. Notifications are sent to an Amazon Simple Notification Service topic, specified by ``--sns-topic-arn``. :: aws rds create-event-subscription \ - --subscription-name my-instance-events --source-type db-instance \ - --event-categories '["backup","recovery"]' \ - --sns-topic-arn arn:aws:sns:us-east-1:123456789012:interesting-events + --subscription-name my-instance-events \ + --source-type db-instance \ + --event-categories '["backup","recovery"]' \ + --sns-topic-arn arn:aws:sns:us-east-1:123456789012:interesting-events Output:: -{ - "EventSubscription": { - "Status": "creating", - "CustSubscriptionId": "my-instance-events", - "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", - "EventCategoriesList": [ - "backup", - "recovery" - ], - "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", - "CustomerAwsId": "123456789012", - "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", - "SourceType": "db-instance", - "Enabled": true + { + "EventSubscription": { + "Status": "creating", + "CustSubscriptionId": "my-instance-events", + "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", + "EventCategoriesList": [ + "backup", + "recovery" + ], + "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", + "CustomerAwsId": "123456789012", + "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", + "SourceType": "db-instance", + "Enabled": true + } } -} - diff --git a/bin/awscli/examples/rds/create-option-group.rst b/bin/awscli/examples/rds/create-option-group.rst index 7aee45cd..9217f0ab 100644 --- a/bin/awscli/examples/rds/create-option-group.rst +++ b/bin/awscli/examples/rds/create-option-group.rst @@ -1,15 +1,23 @@ **To Create an Amazon RDS option group** -The following ``create-option-group`` command creates a new Amazon RDS option group:: +The following ``create-option-group`` command creates a new Amazon RDS option group for ``Oracle Enterprise Edition`` version ``11.2`, is named ``MyOptionGroup`` and includes a description. :: - aws rds create-option-group --option-group-name MyOptionGroup --engine-name oracle-ee --major-engine-version 11.2 --option-group-description "Oracle Database Manager Database Control" + aws rds create-option-group \ + --option-group-name MyOptionGroup \ + --engine-name oracle-ee \ + --major-engine-version 11.2 \ + --option-group-description "Oracle Database Manager Database Control" -In the example, the option group is created for Oracle Enterprise Edition version *11.2*, is named *MyOptionGroup* and -includes a description. - -This command output a JSON block that contains information on the option group. - -For more information, see `Create an Amazon RDS Option Group`_ in the *AWS Command Line Interface User Guide*. - -.. _`Create an Amazon RDS Option Group`: http://docs.aws.amazon.com/cli/latest/userguide/cli-rds-create-option-group.html +Output:: + { + "OptionGroup": { + "OptionGroupName": "myoptiongroup", + "OptionGroupDescription": "Oracle Database Manager Database Control", + "EngineName": "oracle-ee", + "MajorEngineVersion": "11.2", + "Options": [], + "AllowsVpcAndNonVpcInstanceMemberships": true, + "OptionGroupArn": "arn:aws:rds:us-west-2:123456789012:og:myoptiongroup" + } + } diff --git a/bin/awscli/examples/rds/delete-db-instance.rst b/bin/awscli/examples/rds/delete-db-instance.rst index 8e4a6d81..c5f2f2b1 100644 --- a/bin/awscli/examples/rds/delete-db-instance.rst +++ b/bin/awscli/examples/rds/delete-db-instance.rst @@ -1,23 +1,17 @@ **To delete a DB instance** -This example deletes a DB instance (*test-instance*), but only after creating a final DB snapshot (*test-instance-final-snap*):: +The following ``delete-db-instance`` example deletes the specified DB instance after creating a final DB snapshot named ``test-instance-final-snap``. :: - aws rds delete-db-instance --db-instance-identifier test-instance \ - --final-db-snapshot-identifier test-instance-final-snap + aws rds delete-db-instance \ + --db-instance-identifier test-instance \ + --final-db-snapshot-identifier test-instance-final-snap Output:: -{ - "DBInstance": { - -<...output omitted...> - - "DBInstanceIdentifier": "test-instance", - -<...output omitted...> - - "DBInstanceStatus": "deleting", - -<...output omitted...> - -} + { + "DBInstance": { + "DBInstanceIdentifier": "test-instance", + "DBInstanceStatus": "deleting", + ...some output truncated... + } + } diff --git a/bin/awscli/examples/rds/delete-event-subscription.rst b/bin/awscli/examples/rds/delete-event-subscription.rst index c2427677..624cc8bc 100644 --- a/bin/awscli/examples/rds/delete-event-subscription.rst +++ b/bin/awscli/examples/rds/delete-event-subscription.rst @@ -1,27 +1,27 @@ **To delete an event subscription** -This example deletes an existing event subscription. +The following ``delete-event-subscription`` example deletes the specified event subscription. :: aws rds delete-event-subscription --subscription-name my-instance-events Output:: -{ - "EventSubscription": { - "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", - "CustomerAwsId": "123456789012", - "Enabled": false, - "SourceIdsList": [ - "test-instance" - ], - "SourceType": "db-instance", - "EventCategoriesList": [ - "backup", - "recovery" - ], - "SubscriptionCreationTime": "2018-07-31 23:22:01.893", - "CustSubscriptionId": "my-instance-events", - "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", - "Status": "deleting" + { + "EventSubscription": { + "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", + "CustomerAwsId": "123456789012", + "Enabled": false, + "SourceIdsList": [ + "test-instance" + ], + "SourceType": "db-instance", + "EventCategoriesList": [ + "backup", + "recovery" + ], + "SubscriptionCreationTime": "2018-07-31 23:22:01.893", + "CustSubscriptionId": "my-instance-events", + "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", + "Status": "deleting" + } } -} diff --git a/bin/awscli/examples/rds/describe-account-attributes.rst b/bin/awscli/examples/rds/describe-account-attributes.rst index 857a52da..cd105cda 100644 --- a/bin/awscli/examples/rds/describe-account-attributes.rst +++ b/bin/awscli/examples/rds/describe-account-attributes.rst @@ -1,87 +1,87 @@ **To describe account attributes** -This example describes the attributes of the current AWS account: +The following ``describe-account-attributes`` example retrieves the attributes for the current AWS account. :: aws rds describe-account-attributes Output:: -{ - "AccountQuotas": [ - { - "Max": 40, - "Used": 4, - "AccountQuotaName": "DBInstances" - }, - { - "Max": 40, - "Used": 0, - "AccountQuotaName": "ReservedDBInstances" - }, - { - "Max": 100000, - "Used": 40, - "AccountQuotaName": "AllocatedStorage" - }, - { - "Max": 25, - "Used": 0, - "AccountQuotaName": "DBSecurityGroups" - }, - { - "Max": 20, - "Used": 0, - "AccountQuotaName": "AuthorizationsPerDBSecurityGroup" - }, - { - "Max": 50, - "Used": 1, - "AccountQuotaName": "DBParameterGroups" - }, - { - "Max": 100, - "Used": 3, - "AccountQuotaName": "ManualSnapshots" - }, - { - "Max": 20, - "Used": 0, - "AccountQuotaName": "EventSubscriptions" - }, - { - "Max": 50, - "Used": 1, - "AccountQuotaName": "DBSubnetGroups" - }, - { - "Max": 20, - "Used": 1, - "AccountQuotaName": "OptionGroups" - }, - { - "Max": 20, - "Used": 6, - "AccountQuotaName": "SubnetsPerDBSubnetGroup" - }, - { - "Max": 5, - "Used": 0, - "AccountQuotaName": "ReadReplicasPerMaster" - }, - { - "Max": 40, - "Used": 1, - "AccountQuotaName": "DBClusters" - }, - { - "Max": 50, - "Used": 0, - "AccountQuotaName": "DBClusterParameterGroups" - }, - { - "Max": 5, - "Used": 0, - "AccountQuotaName": "DBClusterRoles" - } - ] -} + { + "AccountQuotas": [ + { + "Max": 40, + "Used": 4, + "AccountQuotaName": "DBInstances" + }, + { + "Max": 40, + "Used": 0, + "AccountQuotaName": "ReservedDBInstances" + }, + { + "Max": 100000, + "Used": 40, + "AccountQuotaName": "AllocatedStorage" + }, + { + "Max": 25, + "Used": 0, + "AccountQuotaName": "DBSecurityGroups" + }, + { + "Max": 20, + "Used": 0, + "AccountQuotaName": "AuthorizationsPerDBSecurityGroup" + }, + { + "Max": 50, + "Used": 1, + "AccountQuotaName": "DBParameterGroups" + }, + { + "Max": 100, + "Used": 3, + "AccountQuotaName": "ManualSnapshots" + }, + { + "Max": 20, + "Used": 0, + "AccountQuotaName": "EventSubscriptions" + }, + { + "Max": 50, + "Used": 1, + "AccountQuotaName": "DBSubnetGroups" + }, + { + "Max": 20, + "Used": 1, + "AccountQuotaName": "OptionGroups" + }, + { + "Max": 20, + "Used": 6, + "AccountQuotaName": "SubnetsPerDBSubnetGroup" + }, + { + "Max": 5, + "Used": 0, + "AccountQuotaName": "ReadReplicasPerMaster" + }, + { + "Max": 40, + "Used": 1, + "AccountQuotaName": "DBClusters" + }, + { + "Max": 50, + "Used": 0, + "AccountQuotaName": "DBClusterParameterGroups" + }, + { + "Max": 5, + "Used": 0, + "AccountQuotaName": "DBClusterRoles" + } + ] + } diff --git a/bin/awscli/examples/rds/describe-certificates.rst b/bin/awscli/examples/rds/describe-certificates.rst index 27737dfc..168660e0 100644 --- a/bin/awscli/examples/rds/describe-certificates.rst +++ b/bin/awscli/examples/rds/describe-certificates.rst @@ -1,20 +1,20 @@ **To describe certificates** -This example describes the certificate associated with the us-east-1 region:: +The following ``describe-certificates`` example retrieves the details of the certificate associated with the user's default region. :: aws rds describe-certificates Output:: -{ - "Certificates": [ - { - "Thumbprint": "34478a908a83ae45dcb61676d235ece975c62c63", - "ValidFrom": "2015-02-05T21:54:04Z", - "CertificateIdentifier": "rds-ca-2015", - "ValidTill": "2020-03-05T21:54:04Z", - "CertificateType": "CA", - "CertificateArn": "arn:aws:rds:us-east-1::cert:rds-ca-2015" - } - ] -} + { + "Certificates": [ + { + "Thumbprint": "34478a908a83ae45dcb61676d235ece975c62c63", + "ValidFrom": "2015-02-05T21:54:04Z", + "CertificateIdentifier": "rds-ca-2015", + "ValidTill": "2020-03-05T21:54:04Z", + "CertificateType": "CA", + "CertificateArn": "arn:aws:rds:us-east-1::cert:rds-ca-2015" + } + ] + } diff --git a/bin/awscli/examples/rds/describe-db-instances.rst b/bin/awscli/examples/rds/describe-db-instances.rst index 798ac3e3..79b4b224 100644 --- a/bin/awscli/examples/rds/describe-db-instances.rst +++ b/bin/awscli/examples/rds/describe-db-instances.rst @@ -1,23 +1,24 @@ **To describe a DB instance** -This example describes a single DB instance (*test-instance*):: +The following ``describe-db-instances`` example retrieves details about the specified DB instance. :: - aws rds describe-db-instances --db-instance-identifier test-instance + aws rds describe-db-instances \ + --db-instance-identifier test-instance Output:: -{ - "DBInstance": { - "DBInstanceIdentifier": "test-instance", - "DBInstanceClass": "db.m1.small", - "Engine": "mysql", - "DBInstanceStatus": "available", - "MasterUsername": "myawsuser", - "Endpoint": { - "Address": "test-instance.cdgmuqiadpid.us-east-1.rds.amazonaws.com", - "Port": 3306, - "HostedZoneId": "Z2R2ITUGPM61AM" - }, -<...output omitted...> - -} + { + "DBInstance": { + "DBInstanceIdentifier": "test-instance", + "DBInstanceClass": "db.m1.small", + "Engine": "mysql", + "DBInstanceStatus": "available", + "MasterUsername": "myawsuser", + "Endpoint": { + "Address": "test-instance.cdgmuqiadpid.us-east-1.rds.amazonaws.com", + "Port": 3306, + "HostedZoneId": "Z2R2ITUGPM61AM" + }, + ...some output truncated... + } + } diff --git a/bin/awscli/examples/rds/describe-db-log-files.rst b/bin/awscli/examples/rds/describe-db-log-files.rst index 832a3642..0e69d5e9 100644 --- a/bin/awscli/examples/rds/describe-db-log-files.rst +++ b/bin/awscli/examples/rds/describe-db-log-files.rst @@ -1,43 +1,43 @@ **To describe the log files for a DB instance** -This example describes the log files for a DB instance (*test-instance*):: +The following ``describe-db-log-files`` example retrieves details about the log files for the specified DB instance. :: - aws rds describe-db-log-files --db-instance-identifier test-instance + aws rds describe-db-log-files -\ + -db-instance-identifier test-instance Output:: - - "DescribeDBLogFiles": [ - { - "Size": 0, - "LastWritten": 1533060000000, - "LogFileName": "error/mysql-error-running.log" - }, - { - "Size": 2683, - "LastWritten": 1532994300000, - "LogFileName": "error/mysql-error-running.log.0" - }, - { - "Size": 107, - "LastWritten": 1533057300000, - "LogFileName": "error/mysql-error-running.log.18" - }, - { - "Size": 13105, - "LastWritten": 1532991000000, - "LogFileName": "error/mysql-error-running.log.23" - }, - { - "Size": 0, - "LastWritten": 1533061200000, - "LogFileName": "error/mysql-error.log" - }, - { - "Size": 3519, - "LastWritten": 1532989252000, - "LogFileName": "mysqlUpgrade" - } - ] -} - + { + "DescribeDBLogFiles": [ + { + "Size": 0, + "LastWritten": 1533060000000, + "LogFileName": "error/mysql-error-running.log" + }, + { + "Size": 2683, + "LastWritten": 1532994300000, + "LogFileName": "error/mysql-error-running.log.0" + }, + { + "Size": 107, + "LastWritten": 1533057300000, + "LogFileName": "error/mysql-error-running.log.18" + }, + { + "Size": 13105, + "LastWritten": 1532991000000, + "LogFileName": "error/mysql-error-running.log.23" + }, + { + "Size": 0, + "LastWritten": 1533061200000, + "LogFileName": "error/mysql-error.log" + }, + { + "Size": 3519, + "LastWritten": 1532989252000, + "LogFileName": "mysqlUpgrade" + } + ] + } diff --git a/bin/awscli/examples/rds/describe-event-categories.rst b/bin/awscli/examples/rds/describe-event-categories.rst index c126c17f..f74dbe96 100644 --- a/bin/awscli/examples/rds/describe-event-categories.rst +++ b/bin/awscli/examples/rds/describe-event-categories.rst @@ -1,67 +1,67 @@ **To describe event categories** -This example describes the event categories for all available event sources:: +The following ``describe-event-categories`` example retrieves details about the event categories for all available event sources. :: aws rds describe-event-categories Output:: -{ - "EventCategoriesMapList": [ - { - "SourceType": "db-instance", - "EventCategories": [ - "deletion", - "read replica", - "failover", - "restoration", - "maintenance", - "low storage", - "configuration change", - "backup", - "creation", - "availability", - "recovery", - "failure", - "backtrack", - "notification" - ] - }, - { - "SourceType": "db-security-group", - "EventCategories": [ - "configuration change", - "failure" - ] - }, - { - "SourceType": "db-parameter-group", - "EventCategories": [ - "configuration change" - ] - }, - { - "SourceType": "db-snapshot", - "EventCategories": [ - "deletion", - "creation", - "restoration", - "notification" - ] - }, - { - "SourceType": "db-cluster", - "EventCategories": [ - "failover", - "failure", - "notification" - ] - }, - { - "SourceType": "db-cluster-snapshot", - "EventCategories": [ - "backup" - ] - } - ] -} + { + "EventCategoriesMapList": [ + { + "SourceType": "db-instance", + "EventCategories": [ + "deletion", + "read replica", + "failover", + "restoration", + "maintenance", + "low storage", + "configuration change", + "backup", + "creation", + "availability", + "recovery", + "failure", + "backtrack", + "notification" + ] + }, + { + "SourceType": "db-security-group", + "EventCategories": [ + "configuration change", + "failure" + ] + }, + { + "SourceType": "db-parameter-group", + "EventCategories": [ + "configuration change" + ] + }, + { + "SourceType": "db-snapshot", + "EventCategories": [ + "deletion", + "creation", + "restoration", + "notification" + ] + }, + { + "SourceType": "db-cluster", + "EventCategories": [ + "failover", + "failure", + "notification" + ] + }, + { + "SourceType": "db-cluster-snapshot", + "EventCategories": [ + "backup" + ] + } + ] + } diff --git a/bin/awscli/examples/rds/describe-event-subscriptions.rst b/bin/awscli/examples/rds/describe-event-subscriptions.rst index c5ef4ec0..911fd0f5 100644 --- a/bin/awscli/examples/rds/describe-event-subscriptions.rst +++ b/bin/awscli/examples/rds/describe-event-subscriptions.rst @@ -1,28 +1,27 @@ **To describe event subscriptions** -This example describes all of the Amazon RDS event subscriptions for the current AWS account: +This example describes all of the Amazon RDS event subscriptions for the current AWS account. :: aws rds describe-event-subscriptions Output:: - "EventSubscriptionsList": [ - { - "EventCategoriesList": [ - "backup", - "recovery" - ], - "Enabled": true, - "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", - "Status": "creating", - "SourceType": "db-instance", - "CustomerAwsId": "123456789012", - "SubscriptionCreationTime": "2018-07-31 23:22:01.893", - "CustSubscriptionId": "my-instance-events", - "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events" - } - ], - -<...output omitted...> - -} + { + "EventSubscriptionsList": [ + { + "EventCategoriesList": [ + "backup", + "recovery" + ], + "Enabled": true, + "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", + "Status": "creating", + "SourceType": "db-instance", + "CustomerAwsId": "123456789012", + "SubscriptionCreationTime": "2018-07-31 23:22:01.893", + "CustSubscriptionId": "my-instance-events", + "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events" + }, + ...some output truncated... + ] + } diff --git a/bin/awscli/examples/rds/describe-events.rst b/bin/awscli/examples/rds/describe-events.rst index 59e5fb33..f97ffbd5 100644 --- a/bin/awscli/examples/rds/describe-events.rst +++ b/bin/awscli/examples/rds/describe-events.rst @@ -1,33 +1,34 @@ **To describe events** -This example describes the events that have occurred for a DB instance (*test-instance*):: +The following ``describe-events`` example retrieves details for the events that have occurred for the specified DB instance. :: aws rds describe-events \ - --source-identifier test-instance --source-type db-instance + --source-identifier test-instance \ + --source-type db-instance Output:: -{ - "Events": [ - { - "SourceType": "db-instance", - "SourceIdentifier": "test-instance", - "EventCategories": [ - "backup" - ], - "Message": "Backing up DB instance", - "Date": "2018-07-31T23:09:23.983Z", - "SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance" - }, - { - "SourceType": "db-instance", - "SourceIdentifier": "test-instance", - "EventCategories": [ - "backup" - ], - "Message": "Finished DB Instance backup", - "Date": "2018-07-31T23:15:13.049Z", - "SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance" - } - ] -} + { + "Events": [ + { + "SourceType": "db-instance", + "SourceIdentifier": "test-instance", + "EventCategories": [ + "backup" + ], + "Message": "Backing up DB instance", + "Date": "2018-07-31T23:09:23.983Z", + "SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance" + }, + { + "SourceType": "db-instance", + "SourceIdentifier": "test-instance", + "EventCategories": [ + "backup" + ], + "Message": "Finished DB Instance backup", + "Date": "2018-07-31T23:15:13.049Z", + "SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance" + } + ] + } diff --git a/bin/awscli/examples/rds/describe-orderable-db-instance-options.rst b/bin/awscli/examples/rds/describe-orderable-db-instance-options.rst index 4cd67d51..3a670dca 100644 --- a/bin/awscli/examples/rds/describe-orderable-db-instance-options.rst +++ b/bin/awscli/examples/rds/describe-orderable-db-instance-options.rst @@ -1,44 +1,46 @@ **To describe orderable DB instance options** -This example describes the orderable options for a DB instances running the MySQL DB engine:: +The following ``describe-orderable-db-instance-options`` example retrieves details about the orderable options for a DB instances running the MySQL DB engine. :: - aws rds describe-orderable-db-instance-options --engine mysql + aws rds describe-orderable-db-instance-options \ + --engine mysql Output:: -{ - "OrderableDBInstanceOptions": [ - { - "MinStorageSize": 5, - "ReadReplicaCapable": true, - "MaxStorageSize": 6144, - "AvailabilityZones": [ - { - "Name": "us-east-1a" - }, - { - "Name": "us-east-1b" - }, - { - "Name": "us-east-1c" - }, - { - "Name": "us-east-1d" - } - ], - "SupportsIops": false, - "AvailableProcessorFeatures": [], - "MultiAZCapable": true, - "DBInstanceClass": "db.m1.large", - "Vpc": true, - "StorageType": "gp2", - "LicenseModel": "general-public-license", - "EngineVersion": "5.5.46", - "SupportsStorageEncryption": false, - "SupportsEnhancedMonitoring": true, - "Engine": "mysql", - "SupportsIAMDatabaseAuthentication": false, - "SupportsPerformanceInsights": false - }, -<...output omitted...> -} + { + "OrderableDBInstanceOptions": [ + { + "MinStorageSize": 5, + "ReadReplicaCapable": true, + "MaxStorageSize": 6144, + "AvailabilityZones": [ + { + "Name": "us-east-1a" + }, + { + "Name": "us-east-1b" + }, + { + "Name": "us-east-1c" + }, + { + "Name": "us-east-1d" + } + ], + "SupportsIops": false, + "AvailableProcessorFeatures": [], + "MultiAZCapable": true, + "DBInstanceClass": "db.m1.large", + "Vpc": true, + "StorageType": "gp2", + "LicenseModel": "general-public-license", + "EngineVersion": "5.5.46", + "SupportsStorageEncryption": false, + "SupportsEnhancedMonitoring": true, + "Engine": "mysql", + "SupportsIAMDatabaseAuthentication": false, + "SupportsPerformanceInsights": false + } + ] + ...some output truncated... + } diff --git a/bin/awscli/examples/rds/describe-reserved-db-instances-offerings.rst b/bin/awscli/examples/rds/describe-reserved-db-instances-offerings.rst index 01df2d36..66839c81 100644 --- a/bin/awscli/examples/rds/describe-reserved-db-instances-offerings.rst +++ b/bin/awscli/examples/rds/describe-reserved-db-instances-offerings.rst @@ -1,32 +1,30 @@ **To describe reserved DB instance offerings** -This example describes reserved DB instance options for *oracle*:: +The following ``describe-reserved-db-instances-offerings`` example retrieves details about reserved DB instance options for ``oracle``. :: aws rds describe-reserved-db-instances-offerings \ - --product-description oracle - + --product-description oracle Output:: -{ - "ReservedDBInstancesOfferings": [ - { - "CurrencyCode": "USD", - "UsagePrice": 0.0, - "ProductDescription": "oracle-se2(li)", - "ReservedDBInstancesOfferingId": "005bdee3-9ef4-4182-aa0c-58ef7cb6c2f8", - "MultiAZ": true, - "DBInstanceClass": "db.m4.xlarge", - "OfferingType": "Partial Upfront", - "RecurringCharges": [ - { - "RecurringChargeAmount": 0.594, - "RecurringChargeFrequency": "Hourly" - } - ], - "FixedPrice": 4089.0, - "Duration": 31536000 - }, -<...output omitted...> - -} + { + "ReservedDBInstancesOfferings": [ + { + "CurrencyCode": "USD", + "UsagePrice": 0.0, + "ProductDescription": "oracle-se2(li)", + "ReservedDBInstancesOfferingId": "005bdee3-9ef4-4182-aa0c-58ef7cb6c2f8", + "MultiAZ": true, + "DBInstanceClass": "db.m4.xlarge", + "OfferingType": "Partial Upfront", + "RecurringCharges": [ + { + "RecurringChargeAmount": 0.594, + "RecurringChargeFrequency": "Hourly" + } + ], + "FixedPrice": 4089.0, + "Duration": 31536000 + }, + ...some output truncated... + } \ No newline at end of file diff --git a/bin/awscli/examples/rds/describe-reserved-db-instances.rst b/bin/awscli/examples/rds/describe-reserved-db-instances.rst index d4d70150..6aabc4fa 100644 --- a/bin/awscli/examples/rds/describe-reserved-db-instances.rst +++ b/bin/awscli/examples/rds/describe-reserved-db-instances.rst @@ -1,6 +1,6 @@ **To describe reserved DB instances** -This example describes reserved DB instances (if any) for the current AWS account:: +The following ``describe-reserved-db-instances`` example retrieves details about any reserved DB instances in the current AWS account. :: - aws rds describe-reserved-db-instances + aws rds describe-reserved-db-instances diff --git a/bin/awscli/examples/rds/describe-source-regions.rst b/bin/awscli/examples/rds/describe-source-regions.rst index d031611e..027ffc1c 100644 --- a/bin/awscli/examples/rds/describe-source-regions.rst +++ b/bin/awscli/examples/rds/describe-source-regions.rst @@ -1,19 +1,67 @@ **To describe source regions** -This example describes all of the source regions:: +The following ``describe-source-regions`` example retrieves details about all of the source regions. :: aws rds describe-source-regions Output:: -{ - "SourceRegions": [ - { - "RegionName": "ap-northeast-1", - "Endpoint": "https://rds.ap-northeast-1.amazonaws.com", - "Status": "available" - }, - -<...output omitted...> - -} + { + "SourceRegions": [ + { + "RegionName": "ap-northeast-1", + "Endpoint": "https://rds.ap-northeast-1.amazonaws.com", + "Status": "available" + }, + { + "RegionName": "ap-northeast-2", + "Endpoint": "https://rds.ap-northeast-2.amazonaws.com", + "Status": "available" + }, + { + "RegionName": "ap-south-1", + "Endpoint": "https://rds.ap-south-1.amazonaws.com", + "Status": "available" + }, + { + "RegionName": "ap-southeast-1", + "Endpoint": "https://rds.ap-southeast-1.amazonaws.com", + "Status": "available" + }, + { + "RegionName": "ap-southeast-2", + "Endpoint": "https://rds.ap-southeast-2.amazonaws.com", + "Status": "available" + }, + { + "RegionName": "eu-central-1", + "Endpoint": "https://rds.eu-central-1.amazonaws.com", + "Status": "available" + }, + { + "RegionName": "eu-west-1", + "Endpoint": "https://rds.eu-west-1.amazonaws.com", + "Status": "available" + }, + { + "RegionName": "eu-west-2", + "Endpoint": "https://rds.eu-west-2.amazonaws.com", + "Status": "available" + }, + { + "RegionName": "sa-east-1", + "Endpoint": "https://rds.sa-east-1.amazonaws.com", + "Status": "available" + }, + { + "RegionName": "us-east-1", + "Endpoint": "https://rds.amazonaws.com", + "Status": "available" + }, + { + "RegionName": "us-west-1", + "Endpoint": "https://rds.us-west-1.amazonaws.com", + "Status": "available" + } + ] + } diff --git a/bin/awscli/examples/rds/describe-valid-db-instance-modifications.rst b/bin/awscli/examples/rds/describe-valid-db-instance-modifications.rst index a5d37ee6..aa4e7cff 100644 --- a/bin/awscli/examples/rds/describe-valid-db-instance-modifications.rst +++ b/bin/awscli/examples/rds/describe-valid-db-instance-modifications.rst @@ -1,95 +1,95 @@ **To describe valid modifications for a DB instance** -This example describes the valid modifications for a DB instance (*test-instance*):: +The following ``describe-valid-db-instance-modifications`` example retrieves details about the valid modifications for the specified DB instance. :: - aws rds describe-valid-db-instance-modifications --db-instance-identifier test-instance + aws rds describe-valid-db-instance-modifications \ + --db-instance-identifier test-instance Output:: -{ - "ValidDBInstanceModificationsMessage": { - "ValidProcessorFeatures": [], - "Storage": [ - { - "StorageSize": [ - { - "Step": 1, - "To": 20, - "From": 20 - }, - { - "Step": 1, - "To": 6144, - "From": 22 - } - ], - "ProvisionedIops": [ - { - "Step": 1, - "To": 0, - "From": 0 - } - ], - "IopsToStorageRatio": [ - { - "To": 0.0, - "From": 0.0 - } - ], - "StorageType": "gp2" - }, - { - "StorageSize": [ - { - "Step": 1, - "To": 6144, - "From": 100 - } - ], - "ProvisionedIops": [ - { - "Step": 1, - "To": 40000, - "From": 1000 - } - ], - "IopsToStorageRatio": [ - { - "To": 50.0, - "From": 1.0 - } - ], - "StorageType": "io1" - }, - { - "StorageSize": [ - { - "Step": 1, - "To": 20, - "From": 20 - }, - { - "Step": 1, - "To": 3072, - "From": 22 - } - ], - "ProvisionedIops": [ - { - "Step": 1, - "To": 0, - "From": 0 - } - ], - "IopsToStorageRatio": [ - { - "To": 0.0, - "From": 0.0 - } - ], - "StorageType": "magnetic" - } - ] + { + "ValidDBInstanceModificationsMessage": { + "ValidProcessorFeatures": [], + "Storage": [ + { + "StorageSize": [ + { + "Step": 1, + "To": 20, + "From": 20 + }, + { + "Step": 1, + "To": 6144, + "From": 22 + } + ], + "ProvisionedIops": [ + { + "Step": 1, + "To": 0, + "From": 0 + } + ], + "IopsToStorageRatio": [ + { + "To": 0.0, + "From": 0.0 + } + ], + "StorageType": "gp2" + }, + { + "StorageSize": [ + { + "Step": 1, + "To": 6144, + "From": 100 + } + ], + "ProvisionedIops": [ + { + "Step": 1, + "To": 40000, + "From": 1000 + } + ], + "IopsToStorageRatio": [ + { + "To": 50.0, + "From": 1.0 + } + ], + "StorageType": "io1" + }, + { + "StorageSize": [ + { + "Step": 1, + "To": 20, + "From": 20 + }, + { + "Step": 1, + "To": 3072, + "From": 22 + } + ], + "ProvisionedIops": [ + { + "Step": 1, + "To": 0, + "From": 0 + } + ], + "IopsToStorageRatio": [ + { + "To": 0.0, + "From": 0.0 + } + ], + "StorageType": "magnetic" + } + ] + } } -} - diff --git a/bin/awscli/examples/rds/download-db-log-file-portion.rst b/bin/awscli/examples/rds/download-db-log-file-portion.rst index 64bee947..3434b57b 100644 --- a/bin/awscli/examples/rds/download-db-log-file-portion.rst +++ b/bin/awscli/examples/rds/download-db-log-file-portion.rst @@ -1,13 +1,18 @@ **To download a DB log file** -By default, this command will only download the latest part of your log file:: +The following ``download-db-log-file-portion`` example downloads only the latest part of your log file, saving it to a local file named ``tail.txt``. :: - aws rds download-db-log-file-portion --db-instance-identifier test-instance \ - --log-file-name log.txt --output text > tail.txt + aws rds download-db-log-file-portion \ + --db-instance-identifier test-instance \ + --log-file-name log.txt \ + --output text > tail.txt -In order to download the entire file, you need `--starting-token 0` parameter:: +To download the entire file, you need to include the ``--starting-token 0`` parameter. The following example saves the output to a local file named ``full.txt``. :: - aws rds download-db-log-file-portion --db-instance-identifier test-instance \ - --log-file-name log.txt --starting-token 0 --output text > full.txt + aws rds download-db-log-file-portion \ + --db-instance-identifier test-instance \ + --log-file-name log.txt \ + --starting-token 0 \ + --output text > full.txt -The downloaded file might contain several blank lines. They appear at the end of each part of the log file while being downloaded. This will generally not cause any trouble in your log file analysis. +The saved file might contain blank lines. They appear at the end of each part of the log file while being downloaded. This generally doesn't cause any trouble in your log file analysis. diff --git a/bin/awscli/examples/rds/generate-auth-token.rst b/bin/awscli/examples/rds/generate-auth-token.rst index 5a6e4fee..b2866a45 100644 --- a/bin/awscli/examples/rds/generate-auth-token.rst +++ b/bin/awscli/examples/rds/generate-auth-token.rst @@ -1,13 +1,13 @@ **To generate an authentication token** -This example generates an authentication token for use with IAM database authentication:: +The following ``generate-db-auth-token`` example generates an authentication token for use with IAM database authentication. :: -aws rds generate-db-auth-token \ - --hostname aurmysql-test.cdgmuqiadpid.us-west-2.rds.amazonaws.com \ - --port 3306 \ - --region us-east-1 \ - --username jane_doe + aws rds generate-db-auth-token \ + --hostname aurmysql-test.cdgmuqiadpid.us-west-2.rds.amazonaws.com \ + --port 3306 \ + --region us-east-1 \ + --username jane_doe Output:: -aurmysql-test.cdgmuqiadpid.us-west-2.rds.amazonaws.com:3306/?Action=connect&DBUser=jane_doe&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIESZCNJ3O4KG2KUA%2F20180731%2Fus-east-1%2Frds-db%2Faws4_request&X-Amz-Date=20180731T235209Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=5a8753ebcfc29a1a2c724e566779721ae6c49d6ec6e3f427191fa41aeb32f0b4 + aurmysql-test.cdgmuqiadpid.us-west-2.rds.amazonaws.com:3306/?Action=connect&DBUser=jane_doe&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIESZCNJ3OEXAMPLE%2F20180731%2Fus-east-1%2Frds-db%2Faws4_request&X-Amz-Date=20180731T235209Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=5a8753ebEXAMPLEa2c724e5667797EXAMPLE9d6ec6e3f427191fa41aeEXAMPLE diff --git a/bin/awscli/examples/rds/modify-db-instance.rst b/bin/awscli/examples/rds/modify-db-instance.rst index 4b4fbc3e..07480493 100644 --- a/bin/awscli/examples/rds/modify-db-instance.rst +++ b/bin/awscli/examples/rds/modify-db-instance.rst @@ -1,24 +1,24 @@ **To modify a DB instance** -This example modifies the instance class of a running DB instance (*test-instance*):: +The following ``modify-db-instance`` example changes the instance class of the specified running DB instance. The ``--apply-immediately`` parameter causes the DB engine to be replaced immediately, instead of waiting until the next maintenance window. :: - aws rds modify-db-instance --db-instance-identifier test-instance \ - --db-instance-class db.m1.large --apply-immediately - -The *--apply-immediately* parameter causes the DB engine to be replaced immediately, instead of waiting until the next maintenance window. + aws rds modify-db-instance \ + --db-instance-identifier test-instance \ + --db-instance-class db.m1.large \ + --apply-immediately Output:: -{ - "DBInstance": { - "DBInstanceIdentifier": "test-instance", - "DBInstanceClass": "db.m1.small", - "Engine": "mysql", - "DBInstanceStatus": "modifying", - <...output omitted...> - "PendingModifiedValues": { - "DBInstanceClass": "db.m1.large" - }, - -<...output omitted...> -} + { + "DBInstance": { + "DBInstanceIdentifier": "test-instance", + "DBInstanceClass": "db.m1.small", + "Engine": "mysql", + "DBInstanceStatus": "modifying", + <...output omitted...> + "PendingModifiedValues": { + "DBInstanceClass": "db.m1.large" + } + <...some output omitted...> + } + } diff --git a/bin/awscli/examples/rds/modify-event-subscription.rst b/bin/awscli/examples/rds/modify-event-subscription.rst index fbca1a61..a27fb132 100644 --- a/bin/awscli/examples/rds/modify-event-subscription.rst +++ b/bin/awscli/examples/rds/modify-event-subscription.rst @@ -1,25 +1,26 @@ **To modify an event subscription** -This example disables an event subscription, so that it no longer publishes notifications to the specified Amazon Simple Notification Service topic:: +The following ``modify-event-subscription`` example disables the specified event subscription, so that it no longer publishes notifications to the specified Amazon Simple Notification Service topic. :: aws rds modify-event-subscription \ - --subscription-name my-instance-events --no-enabled + --subscription-name my-instance-events \ + --no-enabled Output:: -{ - "EventSubscription": { - "EventCategoriesList": [ - "backup", - "recovery" - ], - "CustomerAwsId": "123456789012", - "SourceType": "db-instance", - "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", - "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", - "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", - "CustSubscriptionId": "my-instance-events", - "Status": "modifying", - "Enabled": false + { + "EventSubscription": { + "EventCategoriesList": [ + "backup", + "recovery" + ], + "CustomerAwsId": "123456789012", + "SourceType": "db-instance", + "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", + "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", + "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", + "CustSubscriptionId": "my-instance-events", + "Status": "modifying", + "Enabled": false + } } -} diff --git a/bin/awscli/examples/rds/promote-read-replica.rst b/bin/awscli/examples/rds/promote-read-replica.rst index 3576ee07..f81e4b18 100644 --- a/bin/awscli/examples/rds/promote-read-replica.rst +++ b/bin/awscli/examples/rds/promote-read-replica.rst @@ -1,21 +1,18 @@ **To promote a read replica** -This example promotes a read replica (*test-instance-repl*) so that it becomes a standalone DB instance:: +The following ``promote-read-replica`` example promotes the specified read replica to become a standalone DB instance. :: - aws rds promote-read-replica --db-instance-identifier test-instance-repl + aws rds promote-read-replica \ + --db-instance-identifier test-instance-repl Output:: -{ - "DBInstance": { - "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl", - "StorageType": "standard", - "ReadReplicaSourceDBInstanceIdentifier": "test-instance", - -<...output omitted...> - - "DBInstanceStatus": "modifying", - -<...output omitted...> - -} + { + "DBInstance": { + "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl", + "StorageType": "standard", + "ReadReplicaSourceDBInstanceIdentifier": "test-instance", + "DBInstanceStatus": "modifying", + ...some output truncated... + } + } diff --git a/bin/awscli/examples/rds/purchase-reserved-db-instance.rst b/bin/awscli/examples/rds/purchase-reserved-db-instance.rst index 9846b4da..37dd044b 100644 --- a/bin/awscli/examples/rds/purchase-reserved-db-instance.rst +++ b/bin/awscli/examples/rds/purchase-reserved-db-instance.rst @@ -1,8 +1,7 @@ **To purchase a reserved DB instance offering** -This example purchases a reserved DB instance offering. The *reserved-db-instances-offering-id* must be a valid offering ID, as -returned by the describe-reserved-db-instances-offering command. +The following ``purchase-reserved-db-instances-offering`` example purchases a reserved DB instance offering. The ``reserved-db-instances-offering-id`` must be a valid offering ID, as returned by the ``describe-reserved-db-instances-offering`` command. aws rds purchase-reserved-db-instances-offering \ - --reserved-db-instances-offering-id 438012d3-4a52-4cc7-b2e3-8dff72e0e706 + --reserved-db-instances-offering-id 438012d3-4a52-4cc7-b2e3-8dff72e0e706 diff --git a/bin/awscli/examples/rds/reboot-db-instance.rst b/bin/awscli/examples/rds/reboot-db-instance.rst index 05fd027c..458d3cb8 100644 --- a/bin/awscli/examples/rds/reboot-db-instance.rst +++ b/bin/awscli/examples/rds/reboot-db-instance.rst @@ -1,24 +1,24 @@ **To reboot a DB instance** -This example reboots a DB instance:: +The following ``reboot-db-instance`` example starts a reboot of the specified DB instance. :: - aws rds reboot-db-instance --db-instance-identifier test-instance + aws rds reboot-db-instance \ + --db-instance-identifier test-instance Output:: -{ - "DBInstance": { - "DBInstanceIdentifier": "test-instance", - "DBInstanceClass": "db.m1.small", - "Engine": "mysql", - "DBInstanceStatus": "rebooting", - "MasterUsername": "myawsuser", - "Endpoint": { - "Address": "test-instance.cdgmuqiadpid.us-east-1.rds.amazonaws.com", - "Port": 3306, - "HostedZoneId": "Z2R2ITUGPM61AM" - }, - -<...output omitted...> - -} + { + "DBInstance": { + "DBInstanceIdentifier": "test-instance", + "DBInstanceClass": "db.m1.small", + "Engine": "mysql", + "DBInstanceStatus": "rebooting", + "MasterUsername": "myawsuser", + "Endpoint": { + "Address": "test-instance.cdgmuqiadpid.us-east-1.rds.amazonaws.com", + "Port": 3306, + "HostedZoneId": "Z2R2ITUGPM61AM" + }, + <...some output omitted...> + } + } diff --git a/bin/awscli/examples/rds/remove-source-identifier-from-subscription.rst b/bin/awscli/examples/rds/remove-source-identifier-from-subscription.rst index f5b2c56d..b809d695 100644 --- a/bin/awscli/examples/rds/remove-source-identifier-from-subscription.rst +++ b/bin/awscli/examples/rds/remove-source-identifier-from-subscription.rst @@ -1,30 +1,29 @@ **To remove a source identifier from a subscription** -This example removes a source identifier from an existing subscription:: +The following ``remove-source-identifier`` example removes the specified source identifier from an existing subscription. :: aws rds remove-source-identifier-from-subscription \ - --subscription-name my-instance-events \ - --source-identifier test-instance-repl - + --subscription-name my-instance-events \ + --source-identifier test-instance-repl Output:: -{ - "EventSubscription": { - "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", - "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", - "EventCategoriesList": [ - "backup", - "recovery" - ], - "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", - "Status": "modifying", - "CustSubscriptionId": "my-instance-events", - "CustomerAwsId": "123456789012", - "SourceIdsList": [ - "test-instance" - ], - "SourceType": "db-instance", - "Enabled": false + { + "EventSubscription": { + "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events", + "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018", + "EventCategoriesList": [ + "backup", + "recovery" + ], + "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events", + "Status": "modifying", + "CustSubscriptionId": "my-instance-events", + "CustomerAwsId": "123456789012", + "SourceIdsList": [ + "test-instance" + ], + "SourceType": "db-instance", + "Enabled": false + } } -} diff --git a/bin/awscli/examples/rds/restore-db-instance-from-db-snapshot.rst b/bin/awscli/examples/rds/restore-db-instance-from-db-snapshot.rst index 6aa4ef61..ce4e30e9 100644 --- a/bin/awscli/examples/rds/restore-db-instance-from-db-snapshot.rst +++ b/bin/awscli/examples/rds/restore-db-instance-from-db-snapshot.rst @@ -1,22 +1,17 @@ **To restore a DB instance from a DB snapshot** -This example creates a new DB instance (*restored-test-instance*) from an existing DB snapshot (*test-instance-snap*):: +The following ``restore-db-instance-from-db-snapshot`` example creates a new DB instance named ``restored-test-instance`` from the specified DB snapshot. :: aws rds restore-db-instance-from-db-snapshot \ - --db-instance-identifier restored-test-instance \ - --db-snapshot-identifier test-instance-snap + --db-instance-identifier restored-test-instance \ + --db-snapshot-identifier test-instance-snap Output:: -{ - "DBInstance": { - -<...output omitted...> - - "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:restored-test-instance", - -<...output omitted...> - - "DBInstanceStatus": "creating", - -} + { + "DBInstance": { + "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:restored-test-instance", + "DBInstanceStatus": "creating", + ...some output truncated... + } + } diff --git a/bin/awscli/examples/rds/restore-db-instance-from-s3.rst b/bin/awscli/examples/rds/restore-db-instance-from-s3.rst index 3019393e..287a9024 100644 --- a/bin/awscli/examples/rds/restore-db-instance-from-s3.rst +++ b/bin/awscli/examples/rds/restore-db-instance-from-s3.rst @@ -1,10 +1,10 @@ **To restore a DB instance from a backup in Amazon S3** -This example creates a new DB instance (*restored-test-instance*) from an existing backup in the *my-backups* S3 bucket:: +The following ``restore-db-instance-from-s3`` example creates a new DB instance named ``restored-test-instance`` from an existing backup in the ``my-backups`` S3 bucket. :: aws rds restore-db-instance-from-s3 \ - --db-instance-identifier restored-test-instance \ - --allocated-storage 250 --db-instance-class db.m4.large --engine mysql \ - --master-username master --master-user-password secret99 \ - --s3-bucket-name my-backups --s3-ingestion-role-arn arn:aws:iam::123456789012:role/my-role \ - --source-engine mysql --source-engine-version 5.6.27 + --db-instance-identifier restored-test-instance \ + --allocated-storage 250 --db-instance-class db.m4.large --engine mysql \ + --master-username master --master-user-password secret99 \ + --s3-bucket-name my-backups --s3-ingestion-role-arn arn:aws:iam::123456789012:role/my-role \ + --source-engine mysql --source-engine-version 5.6.27 diff --git a/bin/awscli/examples/rds/restore-db-instance-to-point-in-time.rst b/bin/awscli/examples/rds/restore-db-instance-to-point-in-time.rst index 2c12b518..8e6ea177 100644 --- a/bin/awscli/examples/rds/restore-db-instance-to-point-in-time.rst +++ b/bin/awscli/examples/rds/restore-db-instance-to-point-in-time.rst @@ -1,26 +1,20 @@ **To restore a DB instance to a point in time** -This example restores *test-instance* to a new DB instance (*restored-test-instance*), as of a particular point in time:: +The following ``restore-db-instance-to-point-in-time`` example restores ``test-instance`` to a new DB instance named ``restored-test-instance``, as of the specified time. :: aws rds restore-db-instance-to-point-in-time \ - --source-db-instance-identifier test-instance \ - --target-db-instance restored-test-instance \ - --restore-time 2018-07-30T23:45:00.000Z - + --source-db-instance-identifier test-instance \ + --target-db-instance restored-test-instance \ + --restore-time 2018-07-30T23:45:00.000Z Output:: -{ - "DBInstance": { - "AllocatedStorage": 20, - "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:restored-test-instance", - -<...output omitted...> - - "DBInstanceStatus": "creating", - "DBInstanceIdentifier": "restored-test-instance", - -<...output omitted...> - -} - + { + "DBInstance": { + "AllocatedStorage": 20, + "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:restored-test-instance", + "DBInstanceStatus": "creating", + "DBInstanceIdentifier": "restored-test-instance", + ...some output truncated... + } + } diff --git a/bin/awscli/examples/rds/start-db-instance.rst b/bin/awscli/examples/rds/start-db-instance.rst index ce181152..8ce7d6dd 100644 --- a/bin/awscli/examples/rds/start-db-instance.rst +++ b/bin/awscli/examples/rds/start-db-instance.rst @@ -1,18 +1,15 @@ **To start a DB instance** -This example starts a DB instance:: +The following ``start-db-instance`` example starts the specified DB instance. :: - aws rds start-db-instance --db-instance-identifier test-instance + aws rds start-db-instance \ + --db-instance-identifier test-instance Output:: -{ - "DBInstance": { - -<...output omitted...> - - "DBInstanceStatus": "starting", - -<...output omitted...> - -} + { + "DBInstance": { + "DBInstanceStatus": "starting", + ...some output truncated... + } + } diff --git a/bin/awscli/examples/rds/stop-db-instance.rst b/bin/awscli/examples/rds/stop-db-instance.rst index 12625d51..779a6331 100644 --- a/bin/awscli/examples/rds/stop-db-instance.rst +++ b/bin/awscli/examples/rds/stop-db-instance.rst @@ -1,18 +1,15 @@ **To stop a DB instance** -This example stops a DB instance:: +The following ``stop-db-instance`` example stops the specified DB instance. :: - aws rds stop-db-instance --db-instance-identifier test-instance + aws rds stop-db-instance \ + --db-instance-identifier test-instance Output:: -{ - "DBInstance": { - -<...output omitted...> - - "DBInstanceStatus": "stopping", - -<...output omitted...> - -} + { + "DBInstance": { + "DBInstanceStatus": "stopping", + ...some output truncated... + } + } diff --git a/bin/awscli/examples/redshift/modify-cluster-parameter-group.rst b/bin/awscli/examples/redshift/modify-cluster-parameter-group.rst index 834ea096..5ce26afb 100644 --- a/bin/awscli/examples/redshift/modify-cluster-parameter-group.rst +++ b/bin/awscli/examples/redshift/modify-cluster-parameter-group.rst @@ -1,12 +1,21 @@ -Modify a Parameter in a Parameter Group ---------------------------------------- +**Modify a parameter in a parameter group** -This example shows how to modify the *wlm_json_configuration* parameter for workload management. +The following ``modify-cluster-parameter-group`` example modifies the *wlm_json_configuration* parameter for workload management. It accepts the parameters from a file that contains the JSON contents shown below. :: -Command:: - aws redshift modify-cluster-parameter-group --parameter-group-name myclusterparametergroup --parameters '{"ParameterName":"wlm_json_configuration","ParameterValue":"[{\"user_group\":[\"example_user_group1\"],\"query_group\":[\"example_query_group1\"],\"query_concurrency\":7},{\"query_concurrency\":5}]"}' + aws redshift modify-cluster-parameter-group \ + --parameter-group-name myclusterparametergroup \ + --parameters file://modify_pg.json -Result:: +Contents of ``modify_pg.json``:: + + [ + { + "ParameterName": "wlm_json_configuration", + "ParameterValue": "[{\"user_group\":\"example_user_group1\",\"query_group\": \"example_query_group1\", \"query_concurrency\":7},{\"query_concurrency\":5}]" + } + ] + +Output:: { "ParameterGroupStatus": "Your parameter group has been updated but changes won't get applied until you reboot the associated Clusters.", @@ -15,4 +24,3 @@ Result:: "RequestId": "09974cc0-64cd-11e2-bea9-49e0ce183f07" } } - diff --git a/bin/awscli/examples/resource-groups/create-group.rst b/bin/awscli/examples/resource-groups/create-group.rst new file mode 100644 index 00000000..282eedb0 --- /dev/null +++ b/bin/awscli/examples/resource-groups/create-group.rst @@ -0,0 +1,41 @@ +**Example 1: To create a tag-based resource group** + +The following ``create-group`` example creates a tag-based resource group of Amazon EC2 instances in the current region that are tagged with a tag key of ``Name``, and a tag key value of ``WebServers``. The group name is ``WebServer3``. :: + + aws resource-groups create-group \ + --name WebServer3 \ + --resource-query '{"Type":"TAG_FILTERS_1_0", "Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"}' + +Output:: + + { + "Group": { + "GroupArn": "arn:aws:resource-groups:us-east-2:000000000000:group/WebServer3", + "Name": "WebServer3" + }, + "ResourceQuery": { + "Type": "TAG_FILTERS_1_0", + "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}" + } + } + +**Example 2: To create a CloudFormation stack-based resource group** + +The following ``create-group`` example creates an AWS CloudFormation stack-based resource group named ``sampleCFNstackgroup``. The query allows all resources that are in the CloudFormation stack that are supported by AWS Resource Groups. :: + + aws resource-groups create-group \ + --name sampleCFNstackgroup \ + --resource-query '{"Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-east-2:123456789012:stack/testcloudformationstack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}' + +Output:: + + { + "Group": { + "GroupArn": "arn:aws:resource-groups:us-east-2:123456789012:group/sampleCFNstackgroup", + "Name": "sampleCFNstackgroup" + }, + "ResourceQuery": { + "Type": "CLOUDFORMATION_STACK_1_0", + "Query":'{\"CloudFormationStackArn\":\"arn:aws:cloudformation:us-east-2:123456789012:stack/testcloudformationstack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\",\"ResourceTypeFilters\":[\"AWS::AllSupported\"]}"}' + } + } diff --git a/bin/awscli/examples/resource-groups/update-group-query.rst b/bin/awscli/examples/resource-groups/update-group-query.rst new file mode 100644 index 00000000..3d8894e6 --- /dev/null +++ b/bin/awscli/examples/resource-groups/update-group-query.rst @@ -0,0 +1,41 @@ +**Example 1: To update the query for a tag-based resource group** + +The following ``update-group-query`` example updates the query for a tag-based resource group of Amazon EC2 instances. To update the group query, you can change the values specified for ``ResourceTypeFilters`` or ``TagFilters``. :: + + aws resource-groups update-group-query \ + --group-name WebServer3 \ + --resource-query '{"Type":"TAG_FILTERS_1_0", "Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"}' + +Output:: + + { + "Group": { + "GroupArn": "arn:aws:resource-groups:us-east-2:123456789012:group/WebServer3", + "Name": "WebServer3" + }, + "ResourceQuery": { + "Type": "TAG_FILTERS_1_0", + "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}" + } + } + +**Example 2: To update the query for a CloudFormation stack-based resource group** + +The following ``update-group-query`` example updates the query for an AWS CloudFormation stack-based resource group named ``sampleCFNstackgroup``. To update the group query, you can change the values specified for ``ResourceTypeFilters`` or ``StackIdentifier``. :: + + aws resource-groups update-group-query \ + --group-name sampleCFNstackgroup \ + --resource-query '{"Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-east-2:123456789012:stack/testcloudformationstack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}' + +Output:: + + { + "Group": { + "GroupArn": "arn:aws:resource-groups:us-east-2:123456789012:group/sampleCFNstackgroup", + "Name": "sampleCFNstackgroup" + }, + "ResourceQuery": { + "Type": "CLOUDFORMATION_STACK_1_0", + "Query":'{\"CloudFormationStackArn\":\"arn:aws:cloudformation:us-east-2:123456789012:stack/testcloudformationstack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\",\"ResourceTypeFilters\":[\"AWS::AllSupported\"]}"}' + } + } diff --git a/bin/awscli/examples/resource-groups/update-group.rst b/bin/awscli/examples/resource-groups/update-group.rst new file mode 100644 index 00000000..4bfb141e --- /dev/null +++ b/bin/awscli/examples/resource-groups/update-group.rst @@ -0,0 +1,17 @@ +**To update the description for a resource group** + +The following ``update-group`` example updates the description for a group named ``WebServer3`` in the current region. :: + + aws resource-groups update-group \ + --group-name WebServer3 \ + --description "Group of web server resources." + +Output:: + + { + "Group": { + "GroupArn": "arn:aws:resource-groups:us-east-2:123456789012:group/WebServer3", + "Name": "WebServer3" + "Description": "Group of web server resources." + } + } diff --git a/bin/awscli/examples/robomaker/batch-describe-simulation-job.rst b/bin/awscli/examples/robomaker/batch-describe-simulation-job.rst new file mode 100644 index 00000000..b2059f10 --- /dev/null +++ b/bin/awscli/examples/robomaker/batch-describe-simulation-job.rst @@ -0,0 +1,150 @@ +**To batch describe simulation jobs** + +The following ``batch-describe-simulation-job`` example retrieves details for the three specified simulation jobs. + +Command:: + + aws robomaker batch-describe-simulation-job \ + --job arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-66bbb3gpxm8x arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-p0cpdrrwng2n arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-g8h6tglmblgw + +Output:: + + { + "jobs": [ + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-66bbb3gpxm8x", + "status": "Completed", + "lastUpdatedAt": 1548959178.0, + "failureBehavior": "Continue", + "clientRequestToken": "6020408e-b05c-4310-9f13-4ed71c5221ed", + "outputLocation": { + "s3Bucket": "awsrobomakerobjecttracker-111111111-bundlesbucket-2lk584kiq1oa", + "s3Prefix": "output" + }, + "maxJobDurationInSeconds": 3600, + "simulationTimeMillis": 0, + "iamRole": "arn:aws:iam::111111111111:role/AWSRoboMakerObjectTracker-154895-SimulationJobRole-14D5ASA7PQE3A", + "simulationApplications": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/AWSRoboMakerObjectTracker-1548959046124_NPvyfcatq/1548959170096", + "applicationVersion": "$LATEST", + "launchConfig": { + "packageName": "object_tracker_simulation", + "launchFile": "local_training.launch", + "environmentVariables": { + "MARKOV_PRESET_FILE": "object_tracker.py", + "MODEL_S3_BUCKET": "awsrobomakerobjecttracker-111111111-bundlesbucket-2lk584kiq1oa", + "MODEL_S3_PREFIX": "model-store", + "ROS_AWS_REGION": "us-west-2" + } + } + } + ], + "tags": {}, + "vpcConfig": { + "subnets": [ + "subnet-716dd52a", + "subnet-43c22325", + "subnet-3f526976" + ], + "securityGroups": [ + "sg-3fb40545" + ], + "vpcId": "vpc-99895eff", + "assignPublicIp": true + } + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-p0cpdrrwng2n", + "status": "Completed", + "lastUpdatedAt": 1548168817.0, + "failureBehavior": "Continue", + "clientRequestToken": "e4a23e75-f9a7-411d-835f-21881c82c58b", + "outputLocation": { + "s3Bucket": "awsrobomakercloudwatch-111111111111-bundlesbucket-14e5s9jvwtmv7", + "s3Prefix": "output" + }, + "maxJobDurationInSeconds": 3600, + "simulationTimeMillis": 0, + "iamRole": "arn:aws:iam::111111111111:role/AWSRoboMakerCloudWatch-154766341-SimulationJobRole-G0OBWTQ8YBG6", + "robotApplications": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/AWSRoboMakerCloudWatch-1547663411642_NZbpqEJ3T/1547663517377", + "applicationVersion": "$LATEST", + "launchConfig": { + "packageName": "cloudwatch_robot", + "launchFile": "await_commands.launch", + "environmentVariables": { + "LAUNCH_ID": "1548168752173", + "ROS_AWS_REGION": "us-west-2" + } + } + } + ], + "simulationApplications": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/AWSRoboMakerCloudWatch-1547663411642_0LIt6D1h6/1547663521470", + "applicationVersion": "$LATEST", + "launchConfig": { + "packageName": "cloudwatch_simulation", + "launchFile": "bookstore_turtlebot_navigation.launch", + "environmentVariables": { + "LAUNCH_ID": "1548168752173", + "ROS_AWS_REGION": "us-west-2", + "TURTLEBOT3_MODEL": "waffle_pi" + } + } + } + ], + "tags": {}, + "vpcConfig": { + "subnets": [ + "subnet-716dd52a", + "subnet-43c22325", + "subnet-3f526976" + ], + "securityGroups": [ + "sg-3fb40545" + ], + "vpcId": "vpc-99895eff", + "assignPublicIp": true + } + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-g8h6tglmblgw", + "status": "Canceled", + "lastUpdatedAt": 1546543442.0, + "failureBehavior": "Fail", + "clientRequestToken": "d796bbb4-2a2c-1abc-f2a9-0d9e547d853f", + "outputLocation": { + "s3Bucket": "sample-bucket", + "s3Prefix": "SimulationLog_115490482698" + }, + "maxJobDurationInSeconds": 28800, + "simulationTimeMillis": 0, + "iamRole": "arn:aws:iam::111111111111:role/RoboMakerSampleTheFirst", + "robotApplications": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/RoboMakerHelloWorldRobot/1546541208251", + "applicationVersion": "$LATEST", + "launchConfig": { + "packageName": "hello_world_robot", + "launchFile": "rotate.launch" + } + } + ], + "simulationApplications": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/RoboMakerHelloWorldSimulation/1546541198985", + "applicationVersion": "$LATEST", + "launchConfig": { + "packageName": "hello_world_simulation", + "launchFile": "empty_world.launch" + } + } + ], + "tags": {} + } + ], + "unprocessedJobs": [] + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/cancel-simulation-job.rst b/bin/awscli/examples/robomaker/cancel-simulation-job.rst new file mode 100644 index 00000000..0a442415 --- /dev/null +++ b/bin/awscli/examples/robomaker/cancel-simulation-job.rst @@ -0,0 +1,6 @@ +**To cancel a simulation job** + +The following ``cancel-simulation-job`` example cancels the specified simulation job. :: + + aws robomaker cancel-simulation-job \ + --job arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-66bbb3gpxm8x diff --git a/bin/awscli/examples/robomaker/create-deployment-job.rst b/bin/awscli/examples/robomaker/create-deployment-job.rst new file mode 100644 index 00000000..82291acb --- /dev/null +++ b/bin/awscli/examples/robomaker/create-deployment-job.rst @@ -0,0 +1,37 @@ +**To create a deployment job** + +This example creates a deployment job for fleet MyFleet. It includes an environment variable named "ENVIRONMENT". +It also attaches a tag named "Region". + +Command:: + + aws robomaker create-deployment-job --deployment-config concurrentDeploymentPercentage=20,failureThresholdPercentage=25 --fleet arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/Trek/1539894765711 --tags Region=West --deployment-application-configs application=arn:aws:robomaker:us-west-2:111111111111:robot-application/RoboMakerVoiceInteractionRobot/1546537110575,applicationVersion=1,launchConfig={environmentVariables={ENVIRONMENT=Beta},launchFile=await_commands.launch,packageName=voice_interaction_robot} + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/sim-0974h36s4v0t", + "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", + "status": "Pending", + "deploymentApplicationConfigs": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/RoboMakerVoiceInteractionRobot/1546537110575", + "applicationVersion": "1", + "launchConfig": { + "packageName": "voice_interaction_robot", + "launchFile": "await_commands.launch", + "environmentVariables": { + "ENVIRONMENT": "Beta" + } + } + } + ], + "createdAt": 1550770236.0, + "deploymentConfig": { + "concurrentDeploymentPercentage": 20, + "failureThresholdPercentage": 25 + }, + "tags": { + "Region": "West" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/create-fleet.rst b/bin/awscli/examples/robomaker/create-fleet.rst new file mode 100644 index 00000000..9d22a835 --- /dev/null +++ b/bin/awscli/examples/robomaker/create-fleet.rst @@ -0,0 +1,18 @@ +**To create a fleet** + +This example creates a fleet. It attaches a tag named Region. + +Command:: + + aws robomaker create-fleet --name MyFleet --tags Region=East + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyOtherFleet/1550771394395", + "name": "MyFleet", + "createdAt": 1550771394.0, + "tags": { + "Region": "East" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/create-robot-application-version.rst b/bin/awscli/examples/robomaker/create-robot-application-version.rst new file mode 100644 index 00000000..a3ff727f --- /dev/null +++ b/bin/awscli/examples/robomaker/create-robot-application-version.rst @@ -0,0 +1,31 @@ +**To create a robot application version** + +This example creates a robot application version. + +Command:: + + aws robomaker create-robot-application-version --application arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551201873931 + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551201873931", + "name": "MyRobotApplication", + "version": "1", + "sources": [ + { + "s3Bucket": "my-bucket", + "s3Key": "my-robot-application.tar.gz", + "etag": "f8cf5526f1c6e7b3a72c3ed3f79c5493-70", + "architecture": "ARMHF" + } + ], + "robotSoftwareSuite": { + "name": "ROS", + "version": "Kinetic" + }, + "lastUpdatedAt": 1551201873.0, + "revisionId": "9986bb8d-a695-4ab4-8810-9f4a74d1aa00" + "tags": {} + } + diff --git a/bin/awscli/examples/robomaker/create-robot-application.rst b/bin/awscli/examples/robomaker/create-robot-application.rst new file mode 100644 index 00000000..ae992690 --- /dev/null +++ b/bin/awscli/examples/robomaker/create-robot-application.rst @@ -0,0 +1,29 @@ +**To create a robot application** + +This example creates a robot application. + +Command:: + + aws robomaker create-robot-application --name MyRobotApplication --sources s3Bucket=my-bucket,s3Key=my-robot-application.tar.gz,architecture=X86_64 --robot-software-suite name=ROS,version=Kinetic + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551201873931", + "name": "MyRobotApplication", + "version": "$LATEST", + "sources": [ + { + "s3Bucket": "my-bucket", + "s3Key": "my-robot-application.tar.gz", + "architecture": "ARMHF" + } + ], + "robotSoftwareSuite": { + "name": "ROS", + "version": "Kinetic" + }, + "lastUpdatedAt": 1551201873.0, + "revisionId": "1f3cb539-9239-4841-a656-d3efcffa07e1", + "tags": {} + } diff --git a/bin/awscli/examples/robomaker/create-robot.rst b/bin/awscli/examples/robomaker/create-robot.rst new file mode 100644 index 00000000..c3c730bf --- /dev/null +++ b/bin/awscli/examples/robomaker/create-robot.rst @@ -0,0 +1,20 @@ +**To create a robot** + +This example creates a robot. It uses the ARMHF architecture. It also attaches a tag named Region. + +Command:: + + aws robomaker create-robot --name MyRobot --architecture ARMHF --greengrass-group-id 0f728a3c-7dbf-4a3e-976d-d16a8360caba --tags Region=East + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398", + "name": "MyRobot", + "createdAt": 1550772325.0, + "greengrassGroupId": "0f728a3c-7dbf-4a3e-976d-d16a8360caba", + "architecture": "ARMHF", + "tags": { + "Region": "East" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/create-simulation-application-version.rst b/bin/awscli/examples/robomaker/create-simulation-application-version.rst new file mode 100644 index 00000000..446b8692 --- /dev/null +++ b/bin/awscli/examples/robomaker/create-simulation-application-version.rst @@ -0,0 +1,39 @@ +**To create a simulation application version** + +This example creates a robot application version. + +Command:: + + aws robomaker create-simulation-application-version --application arn:aws:robomaker:us-west-2:111111111111:robot-application/MySimulationApplication/1551203427605 + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MyRobotApplication/1551203427605", + "name": "MyRobotApplication", + "version": "1", + "sources": [ + { + "s3Bucket": "my-bucket", + "s3Key": "my-simulation-application.tar.gz", + "etag": "00d8a94ff113856688c4fce618ae0f45-94", + "architecture": "X86_64" + } + ], + "simulationSoftwareSuite": { + "name": "Gazebo", + "version": "7" + }, + "robotSoftwareSuite": { + "name": "ROS", + "version": "Kinetic" + }, + "renderingEngine": { + "name": "OGRE", + "version": "1.x" + }, + "lastUpdatedAt": 1551203853.0, + "revisionId": "ee753e53-519c-4d37-895d-65e79bcd1914", + "tags": {} + } + diff --git a/bin/awscli/examples/robomaker/create-simulation-application.rst b/bin/awscli/examples/robomaker/create-simulation-application.rst new file mode 100644 index 00000000..4c528e80 --- /dev/null +++ b/bin/awscli/examples/robomaker/create-simulation-application.rst @@ -0,0 +1,38 @@ +**To create a simulation application** + +This example creates a simulation application. + +Command:: + + aws robomaker create-simulation-application --name MyRobotApplication --sources s3Bucket=my-bucket,s3Key=my-simulation-application.tar.gz,architecture=ARMHF --robot-software-suite name=ROS,version=Kinetic --simulation-software-suite name=Gazebo,version=7 --rendering-engine name=OGRE,version=1.x + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MyRobotApplication/1551203301792", + "name": "MyRobotApplication", + "version": "$LATEST", + "sources": [ + { + "s3Bucket": "my-bucket", + "s3Key": "my-simulation-application.tar.gz", + "architecture": "X86_64" + } + ], + "simulationSoftwareSuite": { + "name": "Gazebo", + "version": "7" + }, + "robotSoftwareSuite": { + "name": "ROS", + "version": "Kinetic" + }, + "renderingEngine": { + "name": "OGRE", + "version": "1.x" + }, + "lastUpdatedAt": 1551203301.0, + "revisionId": "ee753e53-519c-4d37-895d-65e79bcd1914", + "tags": {} + } + diff --git a/bin/awscli/examples/robomaker/create-simulation-job.rst b/bin/awscli/examples/robomaker/create-simulation-job.rst new file mode 100644 index 00000000..d5b4cd86 --- /dev/null +++ b/bin/awscli/examples/robomaker/create-simulation-job.rst @@ -0,0 +1,43 @@ +**To create a simulation job** + +This example creates a simulation job. It uses a robot application and a simulation application. + +Command:: + + aws robomaker create-simulation-job --max-job-duration-in-seconds 3600 --iam-role arn:aws:iam::111111111111:role/AWSRoboMakerCloudWatch-154766341-SimulationJobRole-G0OBWTQ8YBG6 --robot-applications application=arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821,launchConfig={packageName=hello_world_robot,launchFile=rotate.launch} --simulation-applications application=arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605,launchConfig={packageName=hello_world_simulation,launchFile=empty_world.launch} --tags Region=North + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-w7m68wpr05h8", + "status": "Pending", + "lastUpdatedAt": 1551213837.0, + "failureBehavior": "Fail", + "clientRequestToken": "b283ccce-e468-43ee-8642-be76a9d69f15", + "maxJobDurationInSeconds": 3600, + "simulationTimeMillis": 0, + "iamRole": "arn:aws:iam::111111111111:role/MySimulationRole", + "robotApplications": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821", + "applicationVersion": "$LATEST", + "launchConfig": { + "packageName": "hello_world_robot", + "launchFile": "rotate.launch" + } + } + ], + "simulationApplications": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605", + "applicationVersion": "$LATEST", + "launchConfig": { + "packageName": "hello_world_simulation", + "launchFile": "empty_world.launch" + } + } + ], + "tags": { + "Region": "North" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/delete-fleet.rst b/bin/awscli/examples/robomaker/delete-fleet.rst new file mode 100644 index 00000000..3eb7ac6e --- /dev/null +++ b/bin/awscli/examples/robomaker/delete-fleet.rst @@ -0,0 +1,7 @@ +**To delete a fleet** + +This example deletes a fleet. + +Command:: + + aws robomaker delete-fleet --fleet arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771394395 diff --git a/bin/awscli/examples/robomaker/delete-robot-application.rst b/bin/awscli/examples/robomaker/delete-robot-application.rst new file mode 100644 index 00000000..e355da1a --- /dev/null +++ b/bin/awscli/examples/robomaker/delete-robot-application.rst @@ -0,0 +1,7 @@ +**To delete a robot application** + +This example deletes a robot application. + +Command:: + + aws robomaker delete-robot-application --application arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821 diff --git a/bin/awscli/examples/robomaker/delete-robot.rst b/bin/awscli/examples/robomaker/delete-robot.rst new file mode 100644 index 00000000..b36f85b2 --- /dev/null +++ b/bin/awscli/examples/robomaker/delete-robot.rst @@ -0,0 +1,7 @@ +**To delete a robot** + +This example deletes a robot. + +Command:: + + aws robomaker delete-robot --robot arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1540829698778 diff --git a/bin/awscli/examples/robomaker/delete-simulation-application.rst b/bin/awscli/examples/robomaker/delete-simulation-application.rst new file mode 100644 index 00000000..efe076bf --- /dev/null +++ b/bin/awscli/examples/robomaker/delete-simulation-application.rst @@ -0,0 +1,7 @@ +**To delete a simulation application** + +This example deletes a simulation application. + +Command:: + + aws robomaker delete-simulation-application --application arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605 diff --git a/bin/awscli/examples/robomaker/deregister-robot.rst b/bin/awscli/examples/robomaker/deregister-robot.rst new file mode 100644 index 00000000..bda6f5ae --- /dev/null +++ b/bin/awscli/examples/robomaker/deregister-robot.rst @@ -0,0 +1,14 @@ +**To deregister a robot from a fleet** + +This example deregisters a robot from a fleet. + +Command:: + + aws robomaker deregister-robot --fleet arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771358907 --robot arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398 + +Output:: + + { + "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771358907", + "robot": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398" + } diff --git a/bin/awscli/examples/robomaker/describe-deployment-job.rst b/bin/awscli/examples/robomaker/describe-deployment-job.rst new file mode 100644 index 00000000..c4e4e696 --- /dev/null +++ b/bin/awscli/examples/robomaker/describe-deployment-job.rst @@ -0,0 +1,38 @@ +**To describe a deployment job** + +The following ``describe-deployment-job`` example retrieves the details about the specified deployment job. :: + + aws robomaker describe-deployment-job \ + --job arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-xl8qssl6pbcn + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-xl8qssl6pbcn", + "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/Trek/1539894765711", + "status": "InProgress", + "deploymentConfig": { + "concurrentDeploymentPercentage": 20, + "failureThresholdPercentage": 25 + }, + "deploymentApplicationConfigs": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/RoboMakerHelloWorldRobot/1546541208251", + "applicationVersion": "1", + "launchConfig": { + "packageName": "hello_world_robot", + "launchFile": "rotate.launch" + } + } + ], + "createdAt": 1551218369.0, + "robotDeploymentSummary": [ + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1540834232469", + "deploymentStartTime": 1551218376.0, + "status": "Deploying", + "progressDetail": {} + } + ], + "tags": {} + } diff --git a/bin/awscli/examples/robomaker/describe-fleet.rst b/bin/awscli/examples/robomaker/describe-fleet.rst new file mode 100644 index 00000000..1698ae1e --- /dev/null +++ b/bin/awscli/examples/robomaker/describe-fleet.rst @@ -0,0 +1,28 @@ +**To describe a fleet** + +The following ``describe-fleet`` example retrieves the details for the specified fleet. :: + + aws robomaker describe-fleet \ + --fleet arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771358907 + +Output:: + + { + "name": "MyFleet", + "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", + "robots": [ + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1540834232469", + "createdAt": 1540834232.0 + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyOtherRobot/1540829698778", + "createdAt": 1540829698.0 + } + ], + "createdAt": 1539894765.0, + "lastDeploymentStatus": "Succeeded", + "lastDeploymentJob": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-xl8qssl6pbcn", + "lastDeploymentTime": 1551218369.0, + "tags": {} + } diff --git a/bin/awscli/examples/robomaker/describe-robot-application.rst b/bin/awscli/examples/robomaker/describe-robot-application.rst new file mode 100644 index 00000000..137513c0 --- /dev/null +++ b/bin/awscli/examples/robomaker/describe-robot-application.rst @@ -0,0 +1,29 @@ +**To describe a robot application** + +This example describes a robot application. + +Command:: + + aws robomaker describe-robot-application --application arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821 + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821", + "name": "MyRobotApplication", + "version": "$LATEST", + "sources": [ + { + "s3Bucket": "my-bucket", + "s3Key": "my-robot-application.tar.gz", + "architecture": "X86_64" + } + ], + "robotSoftwareSuite": { + "name": "ROS", + "version": "Kinetic" + }, + "revisionId": "e72efe0d-f44f-4333-b604-f6fa5c6bb50b", + "lastUpdatedAt": 1551203485.0, + "tags": {} + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/describe-robot.rst b/bin/awscli/examples/robomaker/describe-robot.rst new file mode 100644 index 00000000..e4c5a581 --- /dev/null +++ b/bin/awscli/examples/robomaker/describe-robot.rst @@ -0,0 +1,21 @@ +**To describe a robot** + +This example describes a robot. + +Command:: + + aws robomaker describe-robot --robot arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398 + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398", + "name": "MyRobot", + "status": "Available", + "greengrassGroupId": "0f728a3c-7dbf-4a3e-976d-d16a8360caba", + "createdAt": 1550772325.0, + "architecture": "ARMHF", + "tags": { + "Region": "East" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/describe-simulation-application.rst b/bin/awscli/examples/robomaker/describe-simulation-application.rst new file mode 100644 index 00000000..578a7c7b --- /dev/null +++ b/bin/awscli/examples/robomaker/describe-simulation-application.rst @@ -0,0 +1,37 @@ +**To describe a simulation application** + +This example describes a simulation application. + +Command:: + + aws robomaker describe-simulation-application --application arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605 + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605", + "name": "MySimulationApplication", + "version": "$LATEST", + "sources": [ + { + "s3Bucket": "my-bucket", + "s3Key": "my-simulation-application.tar.gz", + "architecture": "X86_64" + } + ], + "simulationSoftwareSuite": { + "name": "Gazebo", + "version": "7" + }, + "robotSoftwareSuite": { + "name": "ROS", + "version": "Kinetic" + }, + "renderingEngine": { + "name": "OGRE", + "version": "1.x" + }, + "revisionId": "783674ab-b7b8-42d9-b01f-9373907987e5", + "lastUpdatedAt": 1551203427.0, + "tags": {} + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/describe-simulation-job.rst b/bin/awscli/examples/robomaker/describe-simulation-job.rst new file mode 100644 index 00000000..cfa3a1ad --- /dev/null +++ b/bin/awscli/examples/robomaker/describe-simulation-job.rst @@ -0,0 +1,45 @@ +**To describe a simulation job** + +This example describes a simulation job. + +Command:: + + aws robomaker describe-simulation-job --job arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-pql32v7pfjy6 + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-pql32v7pfjy6", + "status": "Running", + "lastUpdatedAt": 1551219349.0, + "failureBehavior": "Continue", + "clientRequestToken": "a19ec4b5-e50d-3591-33da-c2e593c60615", + "outputLocation": { + "s3Bucket": "my-output-bucket", + "s3Prefix": "output" + }, + "maxJobDurationInSeconds": 3600, + "simulationTimeMillis": 0, + "iamRole": "arn:aws:iam::111111111111:role/MySimulationRole", + "robotApplications": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551206341136", + "applicationVersion": "$LATEST", + "launchConfig": { + "packageName": "hello_world_robot", + "launchFile": "rotate.launch" + } + } + ], + "simulationApplications": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551206347967", + "applicationVersion": "$LATEST", + "launchConfig": { + "packageName": "hello_world_simulation", + "launchFile": "empty_world.launch" + } + } + ], + "tags": {} + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/list-deployment-jobs.rst b/bin/awscli/examples/robomaker/list-deployment-jobs.rst new file mode 100644 index 00000000..e7e87681 --- /dev/null +++ b/bin/awscli/examples/robomaker/list-deployment-jobs.rst @@ -0,0 +1,57 @@ +**To list deployment jobs** + +The following ``list-deployment-jobs`` example retrieves a list of deployment jobs. :: + + aws robomaker list-deployment-jobs + +Output:: + + { + "deploymentJobs": [ + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/sim-6293szzm56rv", + "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", + "status": "InProgress", + "deploymentApplicationConfigs": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/HelloWorldRobot/1546537110575", + "applicationVersion": "1", + "launchConfig": { + "packageName": "hello_world_robot", + "launchFile": "rotate.launch", + "environmentVariables": { + "ENVIRONMENT": "Desert" + } + } + } + ], + "deploymentConfig": { + "concurrentDeploymentPercentage": 20, + "failureThresholdPercentage": 25 + }, + "createdAt": 1550689373.0 + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-4w4g69p25zdb", + "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", + "status": "Pending", + "deploymentApplicationConfigs": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/AWSRoboMakerHelloWorld-1544562726923_YGHM_sh5M/1544562822877", + "applicationVersion": "1", + "launchConfig": { + "packageName": "fail", + "launchFile": "fail" + } + } + ], + "deploymentConfig": { + "concurrentDeploymentPercentage": 20, + "failureThresholdPercentage": 25 + }, + "failureReason": "", + "failureCode": "", + "createdAt": 1544719763.0 + } + ] + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/list-fleets.rst b/bin/awscli/examples/robomaker/list-fleets.rst new file mode 100644 index 00000000..2150e399 --- /dev/null +++ b/bin/awscli/examples/robomaker/list-fleets.rst @@ -0,0 +1,22 @@ +**To list fleets** + +This example lists fleets. A maximum of 20 fleets will be returned. + +Command:: + + aws robomaker list-fleets --max-items 20 + +Output:: + + { + "fleetDetails": [ + { + "name": "Trek", + "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", + "createdAt": 1539894765.0, + "lastDeploymentStatus": "Failed", + "lastDeploymentJob": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-4w4g69p25zdb", + "lastDeploymentTime": 1544719763.0 + } + ] + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/list-robot-applications.rst b/bin/awscli/examples/robomaker/list-robot-applications.rst new file mode 100644 index 00000000..419d62f9 --- /dev/null +++ b/bin/awscli/examples/robomaker/list-robot-applications.rst @@ -0,0 +1,32 @@ +**To list robot applications** + +This example lists robot applications. Results are limited to 20 robot applications. + +Command:: + + aws robomaker list-robot-applications --max-results 20 + +Output:: + + { + "robotApplicationSummaries": [ + { + "name": "MyRobot", + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobot/1546537110575", + "version": "$LATEST", + "lastUpdatedAt": 1546540372.0 + }, + { + "name": "AnotherRobot", + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/AnotherRobot/1546541208251", + "version": "$LATEST", + "lastUpdatedAt": 1546541208.0 + }, + { + "name": "MySuperRobot", + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MySuperRobot/1547663517377", + "version": "$LATEST", + "lastUpdatedAt": 1547663517.0 + } + ] + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/list-robots.rst b/bin/awscli/examples/robomaker/list-robots.rst new file mode 100644 index 00000000..e51b9509 --- /dev/null +++ b/bin/awscli/examples/robomaker/list-robots.rst @@ -0,0 +1,45 @@ +**To list robots** + +This example lists robots. A maximum of 20 robots will be returned. + +Command:: + + aws robomaker list-robots --max-results 20 + +Output:: + + { + "robots": [ + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/Robot100/1544035373264", + "name": "Robot100", + "status": "Available", + "createdAt": 1544035373.0, + "architecture": "X86_64" + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/Robot101/1542146976587", + "name": "Robot101", + "status": "Available", + "createdAt": 1542146976.0, + "architecture": "X86_64" + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/Robot102/1540834232469", + "name": "Robot102", + "fleetArn": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/Trek/1539894765711", + "status": "Available", + "createdAt": 1540834232.0, + "architecture": "X86_64", + "lastDeploymentJob": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-jb007b75gl5f", + "lastDeploymentTime": 1550689533.0 + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1540829698778", + "name": "MyRobot", + "status": "Registered", + "createdAt": 1540829698.0, + "architecture": "X86_64" + } + ] + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/list-simulation-applications.rst b/bin/awscli/examples/robomaker/list-simulation-applications.rst new file mode 100644 index 00000000..107c783e --- /dev/null +++ b/bin/awscli/examples/robomaker/list-simulation-applications.rst @@ -0,0 +1,50 @@ +**To list simulation applications** + +This example lists simulation applications. A maximum of 20 simulation applications will be returned. + +Command:: + + aws robomaker list-simulation-applications --max-results 20 + +Output:: + + { + "simulationApplicationSummaries": [ + { + "name": "AWSRoboMakerObjectTracker-1548959046124_NPvyfcatq", + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/AWSRoboMakerObjectTracker-1548959046124_NPvyfcatq/1548959170096", + "version": "$LATEST", + "lastUpdatedAt": 1548959170.0 + }, + { + "name": "RoboMakerHelloWorldSimulation", + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/RoboMakerHelloWorldSimulation/1546541198985", + "version": "$LATEST", + "lastUpdatedAt": 1546541198.0 + }, + { + "name": "RoboMakerObjectTrackerSimulation", + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/RoboMakerObjectTrackerSimulation/1545846795615", + "version": "$LATEST", + "lastUpdatedAt": 1545847405.0 + }, + { + "name": "RoboMakerVoiceInteractionSimulation", + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/RoboMakerVoiceInteractionSimulation/1546537100507", + "version": "$LATEST", + "lastUpdatedAt": 1546540352.0 + }, + { + "name": "AWSRoboMakerCloudWatch-1547663411642_0LIt6D1h6", + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/AWSRoboMakerCloudWatch-1547663411642_0LIt6D1h6/1547663521470", + "version": "$LATEST", + "lastUpdatedAt": 1547663521.0 + }, + { + "name": "AWSRoboMakerDeepRacer-1545848257672_1YZCaieQ-", + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/AWSRoboMakerDeepRacer-1545848257672_1YZCaieQ-/1545848370525", + "version": "$LATEST", + "lastUpdatedAt": 1545848370.0 + } + ] + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/list-simulation-jobs.rst b/bin/awscli/examples/robomaker/list-simulation-jobs.rst new file mode 100644 index 00000000..b8591608 --- /dev/null +++ b/bin/awscli/examples/robomaker/list-simulation-jobs.rst @@ -0,0 +1,80 @@ +**To list simulation jobs** + +This example lists simulation jobs. + +Command:: + + aws robomaker list-simulation-jobs + +Output:: + + { + "simulationJobSummaries": [ + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-66bbb3gpxm8x", + "lastUpdatedAt": 1548959178.0, + "status": "Completed", + "simulationApplicationNames": [ + "AWSRoboMakerObjectTracker-1548959046124_NPvyfcatq" + ], + "robotApplicationNames": [ + null + ] + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-b27c4rkrtzcw", + "lastUpdatedAt": 1543514088.0, + "status": "Canceled", + "simulationApplicationNames": [ + "AWSRoboMakerPersonDetection-1543513948280_T8rHW2_lu" + ], + "robotApplicationNames": [ + "AWSRoboMakerPersonDetection-1543513948280_EYaMT0mYb" + ] + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-51vxjbzy4q8t", + "lastUpdatedAt": 1543508858.0, + "status": "Canceled", + "simulationApplicationNames": [ + "AWSRoboMakerCloudWatch-1543504747391_lFF9ZQyx6" + ], + "robotApplicationNames": [ + "AWSRoboMakerCloudWatch-1543504747391_axbYa3S3K" + ] + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-kgf1fqxflqbx", + "lastUpdatedAt": 1543504862.0, + "status": "Completed", + "simulationApplicationNames": [ + "AWSRoboMakerCloudWatch-1543504747391_lFF9ZQyx6" + ], + "robotApplicationNames": [ + "AWSRoboMakerCloudWatch-1543504747391_axbYa3S3K" + ] + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-vw8lvh061nqt", + "lastUpdatedAt": 1543441430.0, + "status": "Completed", + "simulationApplicationNames": [ + "AWSRoboMakerHelloWorld-1543437372341__yb_Jg96l" + ], + "robotApplicationNames": [ + "AWSRoboMakerHelloWorld-1543437372341_lNbmKHvs9" + ] + }, + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-txy5ypxmhz84", + "lastUpdatedAt": 1543437488.0, + "status": "Completed", + "simulationApplicationNames": [ + "AWSRoboMakerHelloWorld-1543437372341__yb_Jg96l" + ], + "robotApplicationNames": [ + "AWSRoboMakerHelloWorld-1543437372341_lNbmKHvs9" + ] + } + ] + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/list-tags-for-resource.rst b/bin/awscli/examples/robomaker/list-tags-for-resource.rst new file mode 100644 index 00000000..cfc9c8de --- /dev/null +++ b/bin/awscli/examples/robomaker/list-tags-for-resource.rst @@ -0,0 +1,16 @@ +**To list tags for a resource** + +This example lists tags for an AWS RoboMaker resource. + +Command:: + + aws robomaker list-tags-for-resource --resource-arn "arn:aws:robomaker:us-west-2:111111111111:robot/Robby_the_Robot/1544035373264" + +Output:: + + { + "tags": { + "Region": "North", + "Stage": "Initial" + } + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/register-robot.rst b/bin/awscli/examples/robomaker/register-robot.rst new file mode 100644 index 00000000..18494d48 --- /dev/null +++ b/bin/awscli/examples/robomaker/register-robot.rst @@ -0,0 +1,14 @@ +**To register a robot** + +This example registers a robot to a fleet. + +Command:: + + aws robomaker register-robot --fleet arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771358907 --robot arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398 + +Output:: + + { + "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771358907", + "robot": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398" + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/restart-simulation-job.rst b/bin/awscli/examples/robomaker/restart-simulation-job.rst new file mode 100644 index 00000000..409ce935 --- /dev/null +++ b/bin/awscli/examples/robomaker/restart-simulation-job.rst @@ -0,0 +1,7 @@ +**To restart a simulation** + +This example restarts a simulation. + +Command:: + + aws robomaker restart-simulation-job --job arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-t6rdgt70mftr diff --git a/bin/awscli/examples/robomaker/sync-deployment-job.rst b/bin/awscli/examples/robomaker/sync-deployment-job.rst new file mode 100644 index 00000000..4ae4d593 --- /dev/null +++ b/bin/awscli/examples/robomaker/sync-deployment-job.rst @@ -0,0 +1,30 @@ +**To sync a deployment job** + +This example synchronizes a deployment job. + +Command:: + + aws robomaker sync-deployment-job --fleet arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/Trek/1539894765711 + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-09ccxs3tlfms", + "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", + "status": "Pending", + "deploymentConfig": { + "concurrentDeploymentPercentage": 20, + "failureThresholdPercentage": 25 + }, + "deploymentApplicationConfigs": [ + { + "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1546541208251", + "applicationVersion": "1", + "launchConfig": { + "packageName": "hello_world_simulation", + "launchFile": "empty_world.launch" + } + } + ], + "createdAt": 1551286954.0 + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/tag-resource.rst b/bin/awscli/examples/robomaker/tag-resource.rst new file mode 100644 index 00000000..2a89b558 --- /dev/null +++ b/bin/awscli/examples/robomaker/tag-resource.rst @@ -0,0 +1,7 @@ +**To tag a resource** + +This example tags a resource. It attaches two tags: Region and Stage. + +Command:: + + aws robomaker tag-resource --resource-arn "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1544035373264" --tags Region=North,Stage=Initial diff --git a/bin/awscli/examples/robomaker/untag-resource.rst b/bin/awscli/examples/robomaker/untag-resource.rst new file mode 100644 index 00000000..1a139cc1 --- /dev/null +++ b/bin/awscli/examples/robomaker/untag-resource.rst @@ -0,0 +1,7 @@ +**To untag a resource** + +This example removes a tag from a resource. It removes the Region tag. + +Command:: + + aws robomaker untag-resource --resource-arn "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1544035373264" --tag-keys Region diff --git a/bin/awscli/examples/robomaker/update-robot-application.rst b/bin/awscli/examples/robomaker/update-robot-application.rst new file mode 100644 index 00000000..d6057c8e --- /dev/null +++ b/bin/awscli/examples/robomaker/update-robot-application.rst @@ -0,0 +1,28 @@ +**To update a robot application** + +This example updates a robot application. + +Command:: + + aws robomaker update-robot-application --application arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821 --sources s3Bucket=my-bucket,s3Key=my-robot-application.tar.gz,architecture=X86_64 --robot-software-suite name=ROS,version=Kinetic + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821", + "name": "MyRobotApplication", + "version": "$LATEST", + "sources": [ + { + "s3Bucket": "my-bucket", + "s3Key": "my-robot-application.tar.gz", + "architecture": "X86_64" + } + ], + "robotSoftwareSuite": { + "name": "ROS", + "version": "Kinetic" + }, + "lastUpdatedAt": 1551287993.0, + "revisionId": "20b5e331-24fd-4504-8b8c-531afe5f4c94" + } \ No newline at end of file diff --git a/bin/awscli/examples/robomaker/update-simulation-application.rst b/bin/awscli/examples/robomaker/update-simulation-application.rst new file mode 100644 index 00000000..54388e3f --- /dev/null +++ b/bin/awscli/examples/robomaker/update-simulation-application.rst @@ -0,0 +1,36 @@ +**To update a simulation application** + +This example updates a simulation application. + +Command:: + + aws robomaker update-simulation-application --application arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605 --sources s3Bucket=my-bucket,s3Key=my-simulation-application.tar.gz,architecture=X86_64 --robot-software-suite name=ROS,version=Kinetic --simulation-software-suite name=Gazebo,version=7 --rendering-engine name=OGRE,version=1.x + +Output:: + + { + "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605", + "name": "MySimulationApplication", + "version": "$LATEST", + "sources": [ + { + "s3Bucket": "my-bucket", + "s3Key": "my-simulation-application.tar.gz", + "architecture": "X86_64" + } + ], + "simulationSoftwareSuite": { + "name": "Gazebo", + "version": "7" + }, + "robotSoftwareSuite": { + "name": "ROS", + "version": "Kinetic" + }, + "renderingEngine": { + "name": "OGRE", + "version": "1.x" + }, + "lastUpdatedAt": 1551289361.0, + "revisionId": "4a22cb5d-93c5-4cef-9311-52bdd119b79e" + } \ No newline at end of file diff --git a/bin/awscli/examples/s3/cp.rst b/bin/awscli/examples/s3/cp.rst index 6676ab68..604c8d84 100644 --- a/bin/awscli/examples/s3/cp.rst +++ b/bin/awscli/examples/s3/cp.rst @@ -92,12 +92,12 @@ Output:: You can combine ``--exclude`` and ``--include`` options to copy only objects that match a pattern, excluding all others:: - aws s3 cp s3://mybucket/logs/ s3://mybucket2/logs/ --recursive --exclude "*" --include "*.log" + aws s3 cp s3://mybucket/logs/ s3://mybucket2/logs/ --recursive --exclude "*" --include "*.log" Output:: - copy: s3://mybucket/test/test.log to s3://mybucket2/test/test.log - copy: s3://mybucket/test3.log to s3://mybucket2/test3.log + copy: s3://mybucket/logs/test/test.log to s3://mybucket2/logs/test/test.log + copy: s3://mybucket/logs/test3.log to s3://mybucket2/logs/test3.log **Setting the Access Control List (ACL) while copying an S3 object** diff --git a/bin/awscli/examples/s3/presign.rst b/bin/awscli/examples/s3/presign.rst new file mode 100644 index 00000000..043f0f19 --- /dev/null +++ b/bin/awscli/examples/s3/presign.rst @@ -0,0 +1,23 @@ +**To create a pre-signed URL with the default one hour lifetime that links to an object in an S3 bucket** + +The following ``presign`` command generates a pre-signed URL for a specified bucket and key that is valid for one hour:: + + aws s3 presign s3://awsexamplebucket/test2.txt + +Output:: + + https://awsexamplebucket.s3.amazonaws.com/test2.txt?AWSAccessKeyId=AKIAEXAMPLEACCESSKEY&Signature=EXHCcBe%EXAMPLEKnz3r8O0AgEXAMPLE&Expires=1555531131 + +**To create a pre-signed URL with a custom lifetime that links to an object in an S3 bucket** + +The following ``presign`` command generates a pre-signed URL for a specified bucket and key that is valid for one week:: + + aws s3 presign s3://awsexamplebucket/test2.txt --expires-in 604800 + +Output:: + + https://examplebucket.s3.amazonaws.com/test2.txt?AWSAccessKeyId=AKIAEXAMPLEACCESSKEY&Signature=EXHCcBe%EXAMPLEKnz3r8O0AgEXAMPLE&Expires=1556132848 + +For more information, see `Share an Object with Others`_ in the *S3 Developer Guide* guide. + +.. _`Share an Object with Others`: https://docs.aws.amazon.com/AmazonS3/latest/dev/ShareObjectPreSignedURL.html \ No newline at end of file diff --git a/bin/awscli/examples/s3api/put-bucket-replication.rst b/bin/awscli/examples/s3api/put-bucket-replication.rst index e32730bf..731320b3 100644 --- a/bin/awscli/examples/s3api/put-bucket-replication.rst +++ b/bin/awscli/examples/s3api/put-bucket-replication.rst @@ -1,49 +1,54 @@ -The following command applies a replication configuration to a bucket named ``my-bucket``:: - - aws s3api put-bucket-replication --bucket my-bucket --replication-configuration file://replication.json - -The file ``replication.json`` is a JSON document in the current folder that specifies a replication rule:: - - { - "Role": "arn:aws:iam::123456789012:role/s3-replication-role", - "Rules": [ - { - "Prefix": "", - "Status": "Enabled", - "Destination": { - "Bucket": "arn:aws:s3:::my-bucket-backup", - "StorageClass": "STANDARD" - } - } - ] - } - -The destination bucket must be in a different region and have versioning enabled. The service role must have permission to write to the destination bucket and have a trust relationship that allows Amazon S3 to assume it. - -Example service role permissions:: - - { - "Version": "2012-10-17", - "Statement": [ - { - "Effect": "Allow", - "Action": "s3:*", - "Resource": "*" - } - ] - } - -Trust relationship:: - - { - "Version": "2012-10-17", - "Statement": [ - { - "Effect": "Allow", - "Principal": { - "Service": "s3.amazonaws.com" - }, - "Action": "sts:AssumeRole" - } - ] - } +**To configure replication for an S3 bucket** + +The following ``put-bucket-replication`` example applies a replication configuration to the specified S3 bucket. :: + + aws s3api put-bucket-replication \ + --bucket my-bucket \ + --replication-configuration file://replication.json + +Contents of ``replication.json``:: + + { + "Role": "arn:aws:iam::123456789012:role/s3-replication-role", + "Rules": [ + { + "Status": "Enabled", + "Priority": 1, + "DeleteMarkerReplication": { "Status": "Disabled" }, + "Filter" : { "Prefix": ""}, + "Destination": { + "Bucket": "arn:aws:s3:::my-bucket-backup" + } + } + ] + } + +The destination bucket must be in a different region and have versioning enabled. The specified role must have permission to write to the destination bucket and have a trust relationship that allows Amazon S3 to assume the role. + +Example role permission policy:: + + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": "s3:*", + "Resource": "*" + } + ] + } + +Example trust relationship policy:: + + { + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Principal": { + "Service": "s3.amazonaws.com" + }, + "Action": "sts:AssumeRole" + } + ] + } diff --git a/bin/awscli/examples/serverlessrepo/put-application-policy.rst b/bin/awscli/examples/serverlessrepo/put-application-policy.rst new file mode 100644 index 00000000..c21efe92 --- /dev/null +++ b/bin/awscli/examples/serverlessrepo/put-application-policy.rst @@ -0,0 +1,50 @@ +**Example 1: To share an application publicly** + +The following ``put-application-policy`` shares an application publicly, so anyone can find and deploy your application in the AWS Serverless Application Repository. :: + + aws serverlessrepo put-application-policy \ + --application-id arn:aws:serverlessrepo:us-east-1:123456789012:applications/my-test-application \ + --statements Principals='*',Actions=Deploy + +Output:: + + { + "Statements": [ + { + "Actions": [ + "Deploy" + ], + "Principals": [ + "" + ], + "StatementId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" + } + ] + } + +**Example 2:** To share an application privately + +The following ``put-application-policy`` shares an application privately, so only specific AWS accounts can find and deploy your application in the AWS Serverless Application Repository. :: + + aws serverlessrepo put-application-policy \ + --application-id arn:aws:serverlessrepo:us-east-1:123456789012:applications/my-test-application \ + --statements Principals=111111111111,222222222222,Actions=Deploy + +Output:: + + { + "Statements": [ + { + "Actions": [ + "Deploy" + ], + "Principals": [ + "111111111111", + "222222222222" + ], + "StatementId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" + } + ] + } + +For more information, see `Sharing an Application Through the Console `_ in the *AWS Serverless Application Repository Developer Guide* diff --git a/bin/awscli/examples/ssm/add-tags-to-resource.rst b/bin/awscli/examples/ssm/add-tags-to-resource.rst index 5a0cd8ef..88bf9e6a 100755 --- a/bin/awscli/examples/ssm/add-tags-to-resource.rst +++ b/bin/awscli/examples/ssm/add-tags-to-resource.rst @@ -1,7 +1,27 @@ -**To add tags to a resource** +**Example 1: To add tags to a maintenance window** -This example updates a maintenance window with new tags. There is no output if the command succeeds. +The following ``add-tags-to-resource`` example adds a tag to a maintenance window. Command:: - aws ssm add-tags-to-resource --resource-type "MaintenanceWindow" --resource-id "mw-03eb9db42890fb82d" --tags "Key=Stack,Value=Production" + aws ssm add-tags-to-resource \ + --resource-type "MaintenanceWindow" \ + --resource-id "mw-03eb9db42890fb82d" \ + --tags "Key=Stack,Value=Production" + +This command produces no output. + +**Example 2: To add tags to a parameter** + +The following ``add-tags-to-resource`` example adds two tags to a parameter. + +Command:: + + aws ssm add-tags-to-resource \ + --resource-type "Parameter" \ + --resource-id "My-Parameter" \ + --tags '[{"Key":"Region","Value":"East"},{"Key":"Environment", "Value":"Production"}]' + +This command produces no output. + +For more information, see `Tagging Systems Manager Parameters `__ in the *AWS Systems Manager User Guide*. diff --git a/bin/awscli/examples/ssm/cancel-maintenance-window-execution.rst b/bin/awscli/examples/ssm/cancel-maintenance-window-execution.rst new file mode 100644 index 00000000..7c1df29c --- /dev/null +++ b/bin/awscli/examples/ssm/cancel-maintenance-window-execution.rst @@ -0,0 +1,13 @@ +**To cancel a Maintenance Window execution** + +This example stops a Maintenance Window execution that is already in progress. + +Command:: + + aws ssm cancel-maintenance-window-execution --window-execution-id j2l8d5b5c-mw66-tk4d-r3g9-1d4d1EXAMPLE + +Output:: + + { + "WindowExecutionId": "j2l8d5b5c-mw66-tk4d-r3g9-1d4d1EXAMPLE" + } \ No newline at end of file diff --git a/bin/awscli/examples/ssm/create-association-batch.rst b/bin/awscli/examples/ssm/create-association-batch.rst index 004994f4..792a377f 100644 --- a/bin/awscli/examples/ssm/create-association-batch.rst +++ b/bin/awscli/examples/ssm/create-association-batch.rst @@ -4,59 +4,61 @@ This example associates a configuration document with multiple instances. The ou Command:: - aws ssm create-association-batch --entries "Name=AWS-UpdateSSMAgent,InstanceId=i-0cb2b964d3e14fd9f" "Name=AWS-UpdateSSMAgent,InstanceId=i-0000293ffd8c57862" + aws ssm create-association-batch --entries "Name=AWS-UpdateSSMAgent,InstanceId=i-1234567890abcdef0" "Name=AWS-UpdateSSMAgent,InstanceId=i-9876543210abcdef0" Output:: { "Successful": [ { + "Name": "AWS-UpdateSSMAgent", + "InstanceId": "i-1234567890abcdef0", + "AssociationVersion": "1", + "Date": 1550504725.007, + "LastUpdateAssociationDate": 1550504725.007, "Status": { - "Date": 1487876122.564, - "Message": "Associated with AWS-UpdateSSMAgent", - "Name": "Associated" + "Date": 1550504725.007, + "Name": "Associated", + "Message": "Associated with AWS-UpdateSSMAgent" }, - "Name": "AWS-UpdateSSMAgent", - "InstanceId": "i-0000293ffd8c57862", "Overview": { "Status": "Pending", "DetailedStatus": "Creating" }, - "AssociationId": "d8617c07-2079-4c18-9847-1655fc2698b0", "DocumentVersion": "$DEFAULT", - "LastUpdateAssociationDate": 1487876122.564, - "Date": 1487876122.564, + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", "Targets": [ { + "Key": "InstanceIds", "Values": [ - "i-0000293ffd8c57862" - ], - "Key": "InstanceIds" + "i-1234567890abcdef0" + ] } ] }, { + "Name": "AWS-UpdateSSMAgent", + "InstanceId": "i-9876543210abcdef0", + "AssociationVersion": "1", + "Date": 1550504725.057, + "LastUpdateAssociationDate": 1550504725.057, "Status": { - "Date": 1487876122.595, - "Message": "Associated with AWS-UpdateSSMAgent", - "Name": "Associated" + "Date": 1550504725.057, + "Name": "Associated", + "Message": "Associated with AWS-UpdateSSMAgent" }, - "Name": "AWS-UpdateSSMAgent", - "InstanceId": "i-0cb2b964d3e14fd9f", "Overview": { "Status": "Pending", "DetailedStatus": "Creating" }, - "AssociationId": "2ccfbc46-5fe4-4e5c-ba46-70b56cc93f53", "DocumentVersion": "$DEFAULT", - "LastUpdateAssociationDate": 1487876122.595, - "Date": 1487876122.595, + "AssociationId": "9c9f7f20-5154-4fed-a83e-0123456789ab", "Targets": [ { + "Key": "InstanceIds", "Values": [ - "i-0cb2b964d3e14fd9f" - ], - "Key": "InstanceIds" + "i-9876543210abcdef0" + ] } ] } diff --git a/bin/awscli/examples/ssm/create-document.rst b/bin/awscli/examples/ssm/create-document.rst index b8b840d5..eaf52f19 100644 --- a/bin/awscli/examples/ssm/create-document.rst +++ b/bin/awscli/examples/ssm/create-document.rst @@ -1,8 +1,8 @@ **To create a document** -This example creates a document in your account. The document must be in JSON format. Note that ``file://`` must be referenced followed by the path of the content file. For more information about writing a configuration document, see `Configuration Document`_ in the *SSM API Reference*. +This example creates a document in your account using the JSON format. Note that ``file://`` must be referenced followed by the path of the content file. For more information about writing a Systems Manager document, see `Creating Systems Manager Documents`_ in the *AWS Systems Manager User Guide*. -.. _`Configuration Document`: http://docs.aws.amazon.com/ssm/latest/APIReference/aws-ssm-document.html +.. _`Creating Systems Manager Documents`: https://docs.aws.amazon.com/systems-manager/latest/userguide/create-ssm-doc.html Command:: @@ -36,3 +36,11 @@ Output:: "Description": "Run a script" } } + +**To create a document using the YAML document format** + +This example creates a document in your account using the YAML format which targets the EC2 instance type. Note that ``file://`` must be referenced followed by the path of the content file. + +Command:: + + aws ssm create-document --content file://RunShellScript.yaml --name "RunShellScript" --document-type "Command" --document-format YAML --target-type "/AWS::EC2::Instance" \ No newline at end of file diff --git a/bin/awscli/examples/ssm/create-maintenance-window.rst b/bin/awscli/examples/ssm/create-maintenance-window.rst index efd0d866..0154ca13 100755 --- a/bin/awscli/examples/ssm/create-maintenance-window.rst +++ b/bin/awscli/examples/ssm/create-maintenance-window.rst @@ -1,13 +1,18 @@ -**To create a maintenance window** +**To create a maintenance window that runs only once** -This example creates a new maintenance window with the specified name that runs at 4 PM on every Tuesday for 4 hours, with a 1 hour cutoff, and that allows unassociated targets. +The following ``create-maintenance-window`` creates a new maintenance window that only runs one time at the specified date and time. :: -Command:: - - aws ssm create-maintenance-window --name "My-First-Maintenance-Window" --schedule "cron(0 16 ? * TUE *)" --duration 4 --cutoff 1 --allow-unassociated-targets + aws ssm create-maintenance-window \ + --name test \ + --schedule "at(2019-05-14T15:55:00)" \ + --duration 5 \ + --cutoff 2 \ + --allow-unassociated-targets Output:: - { - "WindowId": "mw-ab12cd34ef56gh78" - } + { + "WindowId": "mw-01234567890abcdef" + } + +For more information, see `Maintenance Windows `_ in the *AWS Systems Manager User Guide*. diff --git a/bin/awscli/examples/ssm/create-resource-data-sync.rst b/bin/awscli/examples/ssm/create-resource-data-sync.rst new file mode 100644 index 00000000..686bd9c3 --- /dev/null +++ b/bin/awscli/examples/ssm/create-resource-data-sync.rst @@ -0,0 +1,7 @@ +**To create a resource data sync** + +This example creates a resource data sync. There is no output if the command succeeds. + +Command:: + + aws ssm create-resource-data-sync --sync-name "ssm-resource-data-sync" --s3-destination "BucketName=ssm-bucket,Prefix=inventory,SyncFormat=JsonSerDe,Region=us-east-1" diff --git a/bin/awscli/examples/ssm/delete-association.rst b/bin/awscli/examples/ssm/delete-association.rst index 8b3181d9..04796653 100644 --- a/bin/awscli/examples/ssm/delete-association.rst +++ b/bin/awscli/examples/ssm/delete-association.rst @@ -4,4 +4,12 @@ This example deletes the association between an instance and a document. There i Command:: - aws ssm delete-association --instance-id "i-0cb2b964d3e14fd9f" --name "AWS-UpdateSSMAgent" + aws ssm delete-association --instance-id "i-1234567890abcdef0" --name "AWS-UpdateSSMAgent" + +**To delete an association using the association ID** + +This example deletes the association for the specified association ID. There is no output if the command succeeds. + +Command:: + + aws ssm delete-association --association-id "8dfe3659-4309-493a-8755-0123456789ab" diff --git a/bin/awscli/examples/ssm/delete-inventory.rst b/bin/awscli/examples/ssm/delete-inventory.rst new file mode 100644 index 00000000..6d81e8e4 --- /dev/null +++ b/bin/awscli/examples/ssm/delete-inventory.rst @@ -0,0 +1,45 @@ +**To delete a custom inventory type** + +This example deletes a custom inventory schema. + +Command:: + + aws ssm delete-inventory --type-name "Custom:RackInfo" --schema-delete-option "DeleteSchema" + +Output:: + + { + "DeletionId": "d72ac9e8-1f60-4d40-b1c6-bf8c78c68c4d", + "TypeName": "Custom:RackInfo", + "DeletionSummary": { + "TotalCount": 1, + "RemainingCount": 1, + "SummaryItems": [ + { + "Version": "1.0", + "Count": 1, + "RemainingCount": 1 + } + ] + } + } + +**To disable a custom inventory type** + +This example disables a custom inventory schema. + +Command:: + + aws ssm delete-inventory --type-name "Custom:RackInfo" --schema-delete-option "DisableSchema" + +Output:: + + { + "DeletionId": "6961492a-8163-44ec-aa1e-923364dd0850", + "TypeName": "Custom:RackInformation", + "DeletionSummary": { + "TotalCount": 0, + "RemainingCount": 0, + "SummaryItems": [] + } + } diff --git a/bin/awscli/examples/ssm/delete-maintenance-window.rst b/bin/awscli/examples/ssm/delete-maintenance-window.rst index 872ca84b..620066e5 100755 --- a/bin/awscli/examples/ssm/delete-maintenance-window.rst +++ b/bin/awscli/examples/ssm/delete-maintenance-window.rst @@ -1,6 +1,6 @@ -**To delete a maintenance window** +**To delete a Maintenance Window** -This example removes a maintenance window. +This example removes a Maintenance Window. Command:: diff --git a/bin/awscli/examples/ssm/delete-parameters.rst b/bin/awscli/examples/ssm/delete-parameters.rst new file mode 100644 index 00000000..42878dcd --- /dev/null +++ b/bin/awscli/examples/ssm/delete-parameters.rst @@ -0,0 +1,17 @@ +**To delete a list of parameters** + +This example deletes a list of parameters. + +Command:: + + aws ssm delete-parameters --names "HelloWorld" "GoodbyeWorld" + +Output:: + + { + "DeletedParameters": [ + "HelloWorld", + "GoodbyeWorld" + ], + "InvalidParameters": [] + } \ No newline at end of file diff --git a/bin/awscli/examples/ssm/delete-resource-data-sync.rst b/bin/awscli/examples/ssm/delete-resource-data-sync.rst new file mode 100644 index 00000000..3512615e --- /dev/null +++ b/bin/awscli/examples/ssm/delete-resource-data-sync.rst @@ -0,0 +1,7 @@ +**To delete a resource data sync** + +This example deletes a resource data sync. There is no output if the command succeeds. + +Command:: + + aws ssm delete-resource-data-sync --sync-name "ssm-resource-data-sync" diff --git a/bin/awscli/examples/ssm/deregister-target-from-maintenance-window.rst b/bin/awscli/examples/ssm/deregister-target-from-maintenance-window.rst index 0541971d..43c3f5e8 100755 --- a/bin/awscli/examples/ssm/deregister-target-from-maintenance-window.rst +++ b/bin/awscli/examples/ssm/deregister-target-from-maintenance-window.rst @@ -1,6 +1,6 @@ -**To remove a target from a maintenance window** +**To remove a target from a Maintenance Window** -This example removes a target from a maintenance window. +This example removes a target from a Maintenance Window. Command:: diff --git a/bin/awscli/examples/ssm/deregister-task-from-maintenance-window.rst b/bin/awscli/examples/ssm/deregister-task-from-maintenance-window.rst index 53711182..91255a76 100755 --- a/bin/awscli/examples/ssm/deregister-task-from-maintenance-window.rst +++ b/bin/awscli/examples/ssm/deregister-task-from-maintenance-window.rst @@ -1,6 +1,6 @@ -**To remove a task from a maintenance window** +**To remove a task from a Maintenance Window** -This example removes a task from a maintenance window. +This example removes a task from a Maintenance Window. Command:: diff --git a/bin/awscli/examples/ssm/describe-activations.rst b/bin/awscli/examples/ssm/describe-activations.rst index 093dde82..380ad03f 100755 --- a/bin/awscli/examples/ssm/describe-activations.rst +++ b/bin/awscli/examples/ssm/describe-activations.rst @@ -11,14 +11,15 @@ Output:: { "ActivationList": [ { - "IamRole": "AutomationRole", - "RegistrationLimit": 10, "ActivationId": "bcf6faa8-83fd-419e-9534-96ad14131eb7", - "ExpirationDate": 1487887903.045, - "CreatedDate": 1487801503.045, + "Description": "test", "DefaultInstanceName": "MyWebServers", - "Expired": false, + "IamRole": "AutomationRole", + "RegistrationLimit": 10, "RegistrationsCount": 0 + "ExpirationDate": 1550176478.734, + "Expired": false, + "CreatedDate": 1550090078.734 } ] } diff --git a/bin/awscli/examples/ssm/describe-association-execution-targets.rst b/bin/awscli/examples/ssm/describe-association-execution-targets.rst new file mode 100644 index 00000000..a8244081 --- /dev/null +++ b/bin/awscli/examples/ssm/describe-association-execution-targets.rst @@ -0,0 +1,28 @@ +**To get details of an association execution** + +This example describes the specified association execution. + +Command:: + + aws ssm describe-association-execution-targets --association-id "8dfe3659-4309-493a-8755-0123456789ab" --execution-id "7abb6378-a4a5-4f10-8312-0123456789ab" + +Output:: + + { + "AssociationExecutionTargets": [ + { + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", + "AssociationVersion": "1", + "ExecutionId": "7abb6378-a4a5-4f10-8312-0123456789ab", + "ResourceId": "i-1234567890abcdef0", + "ResourceType": "ManagedInstance", + "Status": "Success", + "DetailedStatus": "Success", + "LastExecutionDate": 1550505538.497, + "OutputSource": { + "OutputSourceId": "97fff367-fc5a-4299-aed8-0123456789ab", + "OutputSourceType": "RunCommand" + } + } + ] + } diff --git a/bin/awscli/examples/ssm/describe-association-executions.rst b/bin/awscli/examples/ssm/describe-association-executions.rst new file mode 100644 index 00000000..7acb7939 --- /dev/null +++ b/bin/awscli/examples/ssm/describe-association-executions.rst @@ -0,0 +1,57 @@ +**To get details of all executions for an association** + +This example describes all executions of the specified association. + +Command:: + + aws ssm describe-association-executions --association-id "8dfe3659-4309-493a-8755-0123456789ab" + +Output:: + + { + "AssociationExecutions": [ + { + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", + "AssociationVersion": "1", + "ExecutionId": "474925ef-1249-45a2-b93d-0123456789ab", + "Status": "Success", + "DetailedStatus": "Success", + "CreatedTime": 1550505827.119, + "ResourceCountByStatus": "{Success=1}" + }, + { + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", + "AssociationVersion": "1", + "ExecutionId": "7abb6378-a4a5-4f10-8312-0123456789ab", + "Status": "Success", + "DetailedStatus": "Success", + "CreatedTime": 1550505536.843, + "ResourceCountByStatus": "{Success=1}" + }, + ... + ] + } + +**To get details of all executions for an association after a specific date and time** + +This example describes all executions of an association after the specified date and time. + +Command:: + + aws ssm describe-association-executions --association-id "8dfe3659-4309-493a-8755-0123456789ab" --filters "Key=CreatedTime,Value=2019-02-18T16:00:00Z,Type=GREATER_THAN" + +Output:: + + { + "AssociationExecutions": [ + { + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", + "AssociationVersion": "1", + "ExecutionId": "474925ef-1249-45a2-b93d-0123456789ab", + "Status": "Success", + "DetailedStatus": "Success", + "CreatedTime": 1550505827.119, + "ResourceCountByStatus": "{Success=1}" + } + ] + } diff --git a/bin/awscli/examples/ssm/describe-association.rst b/bin/awscli/examples/ssm/describe-association.rst index 595a4071..92234edc 100644 --- a/bin/awscli/examples/ssm/describe-association.rst +++ b/bin/awscli/examples/ssm/describe-association.rst @@ -1,10 +1,81 @@ **To get details of an association** +This example describes the association for the specified association ID. + +Command:: + + aws ssm describe-association --association-id "8dfe3659-4309-493a-8755-0123456789ab" + +Output:: + + { + "AssociationDescription": { + "Name": "AWS-GatherSoftwareInventory", + "AssociationVersion": "1", + "Date": 1534864780.995, + "LastUpdateAssociationDate": 1543235759.81, + "Overview": { + "Status": "Success", + "AssociationStatusAggregatedCount": { + "Success": 2 + } + }, + "DocumentVersion": "$DEFAULT", + "Parameters": { + "applications": [ + "Enabled" + ], + "awsComponents": [ + "Enabled" + ], + "customInventory": [ + "Enabled" + ], + "files": [ + "" + ], + "instanceDetailedInformation": [ + "Enabled" + ], + "networkConfig": [ + "Enabled" + ], + "services": [ + "Enabled" + ], + "windowsRegistry": [ + "" + ], + "windowsRoles": [ + "Enabled" + ], + "windowsUpdates": [ + "Enabled" + ] + }, + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", + "Targets": [ + { + "Key": "InstanceIds", + "Values": [ + "*" + ] + } + ], + "ScheduleExpression": "rate(24 hours)", + "LastExecutionDate": 1550501886.0, + "LastSuccessfulExecutionDate": 1550501886.0, + "AssociationName": "Inventory-Association" + } + } + +**To get details of an association for a specific instance and document** + This example describes the association between an instance and a document. Command:: - aws ssm describe-association --instance-id "i-0000293ffd8c57862" --name "AWS-UpdateSSMAgent" + aws ssm describe-association --instance-id "i-1234567890abcdef0" --name "AWS-UpdateSSMAgent" Output:: @@ -16,7 +87,7 @@ Output:: "Name": "Associated" }, "Name": "AWS-UpdateSSMAgent", - "InstanceId": "i-0000293ffd8c57862", + "InstanceId": "i-1234567890abcdef0", "Overview": { "Status": "Pending", "DetailedStatus": "Associated", @@ -24,14 +95,14 @@ Output:: "Pending": 1 } }, - "AssociationId": "d8617c07-2079-4c18-9847-1655fc2698b0", + "AssociationId": "d8617c07-2079-4c18-9847-1234567890ab", "DocumentVersion": "$DEFAULT", "LastUpdateAssociationDate": 1487876122.564, "Date": 1487876122.564, "Targets": [ { "Values": [ - "i-0000293ffd8c57862" + "i-1234567890abcdef0" ], "Key": "InstanceIds" } diff --git a/bin/awscli/examples/ssm/describe-automation-executions.rst b/bin/awscli/examples/ssm/describe-automation-executions.rst index 98bf5f01..252dc3ac 100755 --- a/bin/awscli/examples/ssm/describe-automation-executions.rst +++ b/bin/awscli/examples/ssm/describe-automation-executions.rst @@ -33,5 +33,5 @@ This example shows the details about a specific Automation Execution. Command:: - aws ssm get-automation-execution --automation-execution-id "4105a4fc-f944-11e6-9d32-8fb2db27a909" + aws ssm describe-automation-executions --filter "Key=ExecutionId,Values=4105a4fc-f944-11e6-9d32-8fb2db27a909" \ No newline at end of file diff --git a/bin/awscli/examples/ssm/describe-automation-step-executions.rst b/bin/awscli/examples/ssm/describe-automation-step-executions.rst new file mode 100644 index 00000000..b243cb02 --- /dev/null +++ b/bin/awscli/examples/ssm/describe-automation-step-executions.rst @@ -0,0 +1,40 @@ +**To get details about all active and terminated step executions in an Automation workflow** + +This example displays the details of all step executions of an Automation workflow. + +Command:: + + aws ssm describe-automation-step-executions --automation-execution-id 4105a4fc-f944-11e6-9d32-0a1b2c3d495h + +Output:: + + { + "StepExecutions": [ + { + "StepName": "startInstances", + "Action": "aws:changeInstanceState", + "ExecutionStartTime": 1550083651.597, + "ExecutionEndTime": 1550083872.358, + "StepStatus": "Success", + "Inputs": { + "DesiredState": "\"running\"", + "InstanceIds": "[\"i-1234567890abcdef0\"]" + }, + "Outputs": { + "InstanceStates": [ + "running" + ] + }, + "StepExecutionId": "bd010896-b1d5-4028-b869-0a1b2c3d4f95", + "OverriddenParameters": {} + } + ] + } + +**To get details about a specific step execution in an Automation workflow** + +This example returns the details for a specific step within an Automation workflow. + +Command:: + + aws ssm describe-automation-step-executions --automation-execution-id 4105a4fc-f944-11e6-9d32-0a1b2c3d495h --filters "Key=StepExecutionId,Values=bd010896-b1d5-4028-b869-0a1b2c3d4f95" diff --git a/bin/awscli/examples/ssm/describe-available-patches.rst b/bin/awscli/examples/ssm/describe-available-patches.rst index 2a0cf672..8ed18a08 100755 --- a/bin/awscli/examples/ssm/describe-available-patches.rst +++ b/bin/awscli/examples/ssm/describe-available-patches.rst @@ -1,45 +1,75 @@ **To get available patches** -This example gets all available patches for Windows Server 2012 that have a MSRC severity of Critical. +This example gets all available patches for Windows Server 2019 that have a MSRC severity of Critical. Command:: - aws ssm describe-available-patches --filters "Key=PRODUCT,Values=WindowsServer2012" "Key=MSRC_SEVERITY,Values=Critical" + aws ssm describe-available-patches --filters "Key=PRODUCT,Values=WindowsServer2019" "Key=MSRC_SEVERITY,Values=Critical" Output:: { "Patches": [ { - "ContentUrl": "https://support.microsoft.com/en-us/kb/2727528", - "ProductFamily": "Windows", - "Product": "WindowsServer2012", + "Id": "fe6bd8c2-3752-4c8b-ab3e-1a7ed08767ba", + "ReleaseDate": 1544047205.0, + "Title": "2018-11 Update for Windows Server 2019 for x64-based Systems (KB4470788)", + "Description": "Install this update to resolve issues in Windows. For a complete listing of the issues that are included in this update, see the associated Microsoft Knowledge Base article for more information. After you install this item, you may have to restart your computer.", + "ContentUrl": "https://support.microsoft.com/en-us/kb/4470788", "Vendor": "Microsoft", - "Description": "A security issue has been identified that could allow an unauthenticated remote attacker to compromise your system and gain control over it. You can help protect your system by installing this update from Microsoft. After you install this update, you may have to restart your system.", + "ProductFamily": "Windows", + "Product": "WindowsServer2019", "Classification": "SecurityUpdates", - "Title": "Security Update for Windows Server 2012 (KB2727528)", - "ReleaseDate": 1352829600.0, - "Language": "All", "MsrcSeverity": "Critical", - "KbNumber": "KB2727528", - "MsrcNumber": "MS12-072", - "Id": "1eb507be-2040-4eeb-803d-abc55700b715" + "KbNumber": "KB4470788", + "MsrcNumber": "", + "Language": "All" }, { - "ContentUrl": "https://support.microsoft.com/en-us/kb/2729462", - "ProductFamily": "Windows", - "Product": "WindowsServer2012", + "Id": "c96115e1-5587-4115-b851-22baa46a3f11", + "ReleaseDate": 1549994410.0, + "Title": "2019-02 Security Update for Adobe Flash Player for Windows Server 2019 for x64-based Systems (KB4487038)", + "Description": "A security issue has been identified in a Microsoft software product that could affect your system. You can help protect your system by installing this update from Microsoft. For a complete listing of the issues that are included in this update, see the associated Microsoft Knowledge Base article. After you install this update, you may have to restart your system.", + "ContentUrl": "https://support.microsoft.com/en-us/kb/4487038", "Vendor": "Microsoft", - "Description": "A security issue has been identified that could allow an unauthenticated remote attacker to compromise your system and gain control over it. You can help protect your system by installing this update from Microsoft. After you install this update, you may have to restart your system.", + "ProductFamily": "Windows", + "Product": "WindowsServer2019", "Classification": "SecurityUpdates", - "Title": "Security Update for Microsoft .NET Framework 3.5 on Windows 8 and Windows Server 2012 for x64-based Systems (KB2729462)", - "ReleaseDate": 1352829600.0, - "Language": "All", "MsrcSeverity": "Critical", - "KbNumber": "KB2729462", - "MsrcNumber": "MS12-074", - "Id": "af873760-c97c-4088-ab7e-5219e120eab4" + "KbNumber": "KB4487038", + "MsrcNumber": "", + "Language": "All" }, - ... - } - } \ No newline at end of file + ... + ] + } + +**To get details of a specific patch** + +This example returns details for the specified patch. + +Command:: + + aws ssm describe-available-patches --filters "Key=PATCH_ID,Values=KB4480979" + +Output:: + + { + "Patches": [ + { + "Id": "680861e3-fb75-432e-818e-d72e5f2be719", + "ReleaseDate": 1546970408.0, + "Title": "2019-01 Security Update for Adobe Flash Player for Windows Server 2016 for x64-based Systems (KB4480979)", + "Description": "A security issue has been identified in a Microsoft software product that could affect your system. You can help protect your system by installing this update from Microsoft. For a complete listing of the issues that are included in this update, see the associated Microsoft Knowledge Base article. After you install this update, you may have to restart your system.", + "ContentUrl": "https://support.microsoft.com/en-us/kb/4480979", + "Vendor": "Microsoft", + "ProductFamily": "Windows", + "Product": "WindowsServer2016", + "Classification": "SecurityUpdates", + "MsrcSeverity": "Critical", + "KbNumber": "KB4480979", + "MsrcNumber": "", + "Language": "All" + } + ] + } diff --git a/bin/awscli/examples/ssm/describe-effective-instance-associations.rst b/bin/awscli/examples/ssm/describe-effective-instance-associations.rst index 038e0bb7..e17b110f 100755 --- a/bin/awscli/examples/ssm/describe-effective-instance-associations.rst +++ b/bin/awscli/examples/ssm/describe-effective-instance-associations.rst @@ -1,19 +1,20 @@ **To get details of the effective associations for an instance** -This example describes the effective associations for an instance. +The following ``describe-effective-instance-associations`` example retrieves details about the effective associations for an instance. Command:: - aws ssm describe-effective-instance-associations --instance-id "i-0000293ffd8c57862" - + aws ssm describe-effective-instance-associations --instance-id "i-1234567890abcdef0" + Output:: - { - "Associations": [ - { - "InstanceId": "i-0000293ffd8c57862", - "Content": "{\n \"schemaVersion\": \"1.2\",\n \"description\": \"Update the Amazon SSM Agent to the latest version or specified version.\",\n \"parameters\": {\n \"version\": {\n \"default\": \"\",\n \"description\": \"(Optional) A specific version of the Amazon SSM Agent to install. If not specified, the agent will be updated to the latest version.\",\n \"type\": \"String\"\n },\n \"allowDowngrade\": {\n \"default\": \"false\",\n \"description\": \"(Optional) Allow the Amazon SSM Agent service to be downgraded to an earlier version. If set to false, the service can be upgraded to newer versions only (default). If set to true, specify the earlier version.\",\n \"type\": \"String\",\n \"allowedValues\": [\n \"true\",\n \"false\"\n ]\n }\n },\n \"runtimeConfig\": {\n \"aws:updateSsmAgent\": {\n \"properties\": [\n {\n \"agentName\": \"amazon-ssm-agent\",\n \"source\": \"https://s3.{Region}.amazonaws.com/amazon-ssm-{Region}/ssm-agent-manifest.json\",\n \"allowDowngrade\": \"{{ allowDowngrade }}\",\n \"targetVersion\": \"{{ version }}\"\n }\n ]\n }\n }\n}\n", - "AssociationId": "d8617c07-2079-4c18-9847-1655fc2698b0" - } - ] - } + { + "Associations": [ + { + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", + "InstanceId": "i-1234567890abcdef0", + "Content": "{\n \"schemaVersion\": \"1.2\",\n \"description\": \"Update the Amazon SSM Agent to the latest version or specified version.\",\n \"parameters\": {\n \"version\": {\n \"default\": \"\",\n \"description\": \"(Optional) A specific version of the Amazon SSM Agent to install. If not specified, the agent will be updated to the latest version.\",\n \"type\": \"String\"\n },\n \"allowDowngrade\": {\n \"default\": \"false\",\n \"description\": \"(Optional) Allow the Amazon SSM Agent service to be downgraded to an earlier version. If set to false, the service can be upgraded to newer versions only (default). If set to true, specify the earlier version.\",\n \"type\": \"String\",\n \"allowedValues\": [\n \"true\",\n \"false\"\n ]\n }\n },\n \"runtimeConfig\": {\n \"aws:updateSsmAgent\": {\n \"properties\": [\n {\n \"agentName\": \"amazon-ssm-agent\",\n \"source\": \"https://s3.{Region}.amazonaws.com/amazon-ssm-{Region}/ssm-agent-manifest.json\",\n \"allowDowngrade\": \"{{ allowDowngrade }}\",\n \"targetVersion\": \"{{ version }}\"\n }\n ]\n }\n }\n}\n", + "AssociationVersion": "1" + } + ] + } diff --git a/bin/awscli/examples/ssm/describe-effective-patches-for-patch-baseline.rst b/bin/awscli/examples/ssm/describe-effective-patches-for-patch-baseline.rst index b9d277e0..98cf3b5c 100755 --- a/bin/awscli/examples/ssm/describe-effective-patches-for-patch-baseline.rst +++ b/bin/awscli/examples/ssm/describe-effective-patches-for-patch-baseline.rst @@ -1,41 +1,60 @@ **To get all patches defined by a patch baseline** -This example returns the patches defined by a patch baseline. +The following ``describe-effective-patches-for-patch-baseline`` example returns the patches defined by a patch baseline. Command:: - aws ssm describe-effective-patches-for-patch-baseline --baseline-id "pb-08b654cf9b9681f04" - + aws ssm describe-effective-patches-for-patch-baseline --baseline-id "pb-08b654cf9b9681f04" + Output:: - { - "NextToken": "--token string truncated--": [ - { - "PatchStatus": { - "ApprovalDate": 1292954400.0, - "DeploymentStatus": "APPROVED" + { + "EffectivePatches": [ + { + "Patch": { + "Id": "fe6bd8c2-3752-4c8b-ab3e-1a7ed08767ba", + "ReleaseDate": 1544047205.0, + "Title": "2018-11 Update for Windows Server 2019 for x64-based Systems (KB4470788)", + "Description": "Install this update to resolve issues in Windows. For a complete listing of the issues that are included in this update, see the associated Microsoft Knowledge Base article for more information. After you install this item, you may have to restart your computer.", + "ContentUrl": "https://support.microsoft.com/en-us/kb/4470788", + "Vendor": "Microsoft", + "ProductFamily": "Windows", + "Product": "WindowsServer2019", + "Classification": "SecurityUpdates", + "MsrcSeverity": "Critical", + "KbNumber": "KB4470788", + "MsrcNumber": "", + "Language": "All" + }, + "PatchStatus": { + "DeploymentStatus": "APPROVED", + "ComplianceLevel": "CRITICAL", + "ApprovalDate": 1544047205.0 + } }, - "Patch": { - "ContentUrl": "https://support.microsoft.com/en-us/kb/2207559", - "ProductFamily": "Windows", - "Product": "WindowsServer2008R2", - "Vendor": "Microsoft", - "Description": "A security issue has been identified that could allow an authenticated remote attacker to cause the affected system to stop responding. You can help protect your system by installing this update from Microsoft. After you install this update, you may have to restart your system.", - "Classification": "SecurityUpdates", - "Title": "Security Update for Windows Server 2008 R2 x64 Edition (KB2207559)", - "ReleaseDate": 1292349600.0, - "Language": "All", - "MsrcSeverity": "Important", - "KbNumber": "KB2207559", - "MsrcNumber": "MS10-101", - "Id": "79d0c8b2-5b35-4455-bfa3-89e0f08fa980" - } - }, - { - "PatchStatus": { - "ApprovalDate": 1285088400.0, - "DeploymentStatus": "APPROVED" + { + "Patch": { + "Id": "915a6b1a-f556-4d83-8f50-b2e75a9a7e58", + "ReleaseDate": 1549994400.0, + "Title": "2019-02 Cumulative Update for .NET Framework 3.5 and 4.7.2 for Windows Server 2019 for x64 (KB4483452)", + "Description": "A security issue has been identified in a Microsoft software product that could affect your system. You can help protect your system by installing this update from Microsoft. For a complete listing of the issues that are included in this update, see the associated Microsoft Knowledge Base article. After you install this update, you may have to restart your system.", + "ContentUrl": "https://support.microsoft.com/en-us/kb/4483452", + "Vendor": "Microsoft", + "ProductFamily": "Windows", + "Product": "WindowsServer2019", + "Classification": "SecurityUpdates", + "MsrcSeverity": "Important", + "KbNumber": "KB4483452", + "MsrcNumber": "", + "Language": "All" + }, + "PatchStatus": { + "DeploymentStatus": "APPROVED", + "ComplianceLevel": "CRITICAL", + "ApprovalDate": 1549994400.0 + } }, - ... - } - } + ... + ], + "NextToken": "--token string truncated--" + } \ No newline at end of file diff --git a/bin/awscli/examples/ssm/describe-instance-associations-status.rst b/bin/awscli/examples/ssm/describe-instance-associations-status.rst index 37ea6ef6..2fbc0cc1 100755 --- a/bin/awscli/examples/ssm/describe-instance-associations-status.rst +++ b/bin/awscli/examples/ssm/describe-instance-associations-status.rst @@ -4,19 +4,33 @@ This example shows details of the associations for an instance. Command:: - aws ssm describe-instance-associations-status --instance-id "i-0000293ffd8c57862" + aws ssm describe-instance-associations-status --instance-id "i-1234567890abcdef0" Output:: { "InstanceAssociationStatusInfos": [ { - "Status": "Pending", - "DetailedStatus": "Associated", + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", + "Name": "AWS-GatherSoftwareInventory", + "DocumentVersion": "1", + "AssociationVersion": "1", + "InstanceId": "i-1234567890abcdef0", + "ExecutionDate": 1550501886.0, + "Status": "Success", + "ExecutionSummary": "1 out of 1 plugin processed, 1 success, 0 failed, 0 timedout, 0 skipped. ", + "AssociationName": "Inventory-Association" + }, + { + "AssociationId": "5c5a31f6-6dae-46f9-944c-0123456789ab", "Name": "AWS-UpdateSSMAgent", - "InstanceId": "i-0000293ffd8c57862", - "AssociationId": "d8617c07-2079-4c18-9847-1655fc2698b0", - "DocumentVersion": "1" + "DocumentVersion": "1", + "AssociationVersion": "1", + "InstanceId": "i-1234567890abcdef0", + "ExecutionDate": 1550505828.548, + "Status": "Success", + "DetailedStatus": "Success", + "AssociationName": "UpdateSSMAgent" } ] } diff --git a/bin/awscli/examples/ssm/describe-instance-information.rst b/bin/awscli/examples/ssm/describe-instance-information.rst index 26cffc0a..2aec9d52 100755 --- a/bin/awscli/examples/ssm/describe-instance-information.rst +++ b/bin/awscli/examples/ssm/describe-instance-information.rst @@ -1,6 +1,6 @@ -**To describe instance information** +**To describe managed instance information** -This example shows details of each of your instances. +This example shows details of each of your managed instances. Command:: @@ -11,33 +11,42 @@ Output:: { "InstanceInformationList": [ { - "IsLatestVersion": true, - "LastSuccessfulAssociationExecutionDate": 1487876123.0, - "ComputerName": "ip-172-31-44-222.us-west-2.compute.internal", + "InstanceId": "i-1234567890abcdef0", "PingStatus": "Online", - "InstanceId": "i-0cb2b964d3e14fd9f", - "IPAddress": "172.31.44.222", - "AssociationStatus": "Success", - "LastAssociationExecutionDate": 1487876123.0, + "LastPingDateTime": 1550501835.178, + "AgentVersion": "2.3.415.0", + "IsLatestVersion": false, + "PlatformType": "Linux", + "PlatformName": "Amazon Linux AMI", + "PlatformVersion": "2018.03", "ResourceType": "EC2Instance", - "AgentVersion": "2.0.672.0", - "PlatformVersion": "2016.09", + "IPAddress": "172.16.0.154", + "ComputerName": "ip-172-16-0-154.ec2.internal", + "AssociationStatus": "Success", + "LastAssociationExecutionDate": 1550501837.0, + "LastSuccessfulAssociationExecutionDate": 1550501837.0, "AssociationOverview": { "InstanceAssociationStatusAggregatedCount": { "Success": 1 } - }, - "PlatformName": "Amazon Linux AMI", - "PlatformType": "Linux", - "LastPingDateTime": 1487898903.758 - } + } + }, + ... ] } -**To describe information about a specific instance** +**To describe information about a specific managed instance** + +This example shows details of the managed instance ``i-1234567890abcdef0``. + +Command:: + + aws ssm describe-instance-information --filters "Key=InstanceIds,Values=i-1234567890abcdef0" + +**To describe information about managed instances with a specific tag key** -This example shows details of instance ``i-0cb2b964d3e14fd9f``. +This example shows details for managed instances that have the tag key ``DEV``. Command:: - aws ssm describe-instance-information --instance-information-filter-list "key=InstanceIds,valueSet=i-0cb2b964d3e14fd9f" + aws ssm describe-instance-information --filters "Key=tag-key,Values=DEV" diff --git a/bin/awscli/examples/ssm/describe-instance-patch-states-for-patch-group.rst b/bin/awscli/examples/ssm/describe-instance-patch-states-for-patch-group.rst index d0fcb611..cedcede7 100755 --- a/bin/awscli/examples/ssm/describe-instance-patch-states-for-patch-group.rst +++ b/bin/awscli/examples/ssm/describe-instance-patch-states-for-patch-group.rst @@ -10,34 +10,37 @@ Output:: { "InstancePatchStates": [ - { - "OperationStartTime":1481259600.0, - "FailedCount":0, - "InstanceId":"i-08ee91c0b17045407", - "OwnerInformation":"", - "NotApplicableCount":2077, - "OperationEndTime":1481259757.0, - "PatchGroup":"Production", - "InstalledOtherCount":186, - "MissingCount":7, - "SnapshotId":"b0e65479-79be-4288-9f88-81c96bc3ed5e", - "Operation":"Scan", - "InstalledCount":72 - }, - { - "OperationStartTime":1481259602.0, - "FailedCount":0, - "InstanceId":"i-0fff3aab684d01b23", - "OwnerInformation":"", - "NotApplicableCount":2692, - "OperationEndTime":1481259613.0, - "PatchGroup":"Production", - "InstalledOtherCount":3, - "MissingCount":1, - "SnapshotId":"b0e65479-79be-4288-9f88-81c96bc3ed5e", - "Operation":"Scan", - "InstalledCount":1 - }, - ... - ] + { + "InstanceId": "i-1234567890abcdef0", + "PatchGroup": "Production", + "BaselineId": "pb-0713accee01234567", + "SnapshotId": "521c3536-930c-4aa9-950e-01234567abcd", + "OwnerInformation": "", + "InstalledCount": 1, + "InstalledOtherCount": 13, + "InstalledRejectedCount": 0, + "MissingCount": 3, + "FailedCount": 0, + "NotApplicableCount": 11, + "OperationStartTime": 1550244665.723, + "OperationEndTime": 1550244826.241, + "Operation": "Scan" + }, + { + "InstanceId": "i-0987654321abcdef0", + "PatchGroup": "Production", + "BaselineId": "pb-0713accee01234567", + "SnapshotId": "521c3536-930c-4aa9-950e-01234567abcd", + "OwnerInformation": "", + "InstalledCount": 1, + "InstalledOtherCount": 7, + "InstalledRejectedCount": 0, + "MissingCount": 1, + "FailedCount": 0, + "NotApplicableCount": 13, + "OperationStartTime": 1550245130.069, + "OperationEndTime": 1550245143.043, + "Operation": "Scan" + } + ] } diff --git a/bin/awscli/examples/ssm/describe-instance-patch-states.rst b/bin/awscli/examples/ssm/describe-instance-patch-states.rst index ca5a0e4c..40e9733f 100755 --- a/bin/awscli/examples/ssm/describe-instance-patch-states.rst +++ b/bin/awscli/examples/ssm/describe-instance-patch-states.rst @@ -4,39 +4,27 @@ This example gets the patch summary states for an instance. Command:: - aws ssm describe-instance-patch-states --instance-ids "i-08ee91c0b17045407" "i-09a618aec652973a9" + aws ssm describe-instance-patch-states --instance-ids "i-1234567890abcdef0" Output:: { "InstancePatchStates": [ - { - "OperationStartTime":"2016-12-09T05:00:00Z", - "FailedCount":0, - "InstanceId":"i-08ee91c0b17045407", - "OwnerInformation":"", - "NotApplicableCount":2077, - "OperationEndTime":"2016-12-09T05:02:37Z", - "PatchGroup":"Production", - "InstalledOtherCount":186, - "MissingCount":7, - "SnapshotId":"b0e65479-79be-4288-9f88-81c96bc3ed5e", - "Operation":"Scan", - "InstalledCount":72 - }, - { - "OperationStartTime":"2016-12-09T04:59:09Z", - "FailedCount":0, - "InstanceId":"i-09a618aec652973a9" - "OwnerInformation":"", - "NotApplicableCount":1637, - "OperationEndTime":"2016-12-09T05:03:57Z", - "PatchGroup":"Production", - "InstalledOtherCount":388, - "MissingCount":2, - "SnapshotId":"b0e65479-79be-4288-9f88-81c96bc3ed5e", - "Operation":"Scan", - "InstalledCount":141 - } - ] + { + "InstanceId": "i-1234567890abcdef0", + "PatchGroup": "", + "BaselineId": "pb-0713accee01234567", + "SnapshotId": "521c3536-930c-4aa9-950e-01234567abcd", + "OwnerInformation": "", + "InstalledCount": 2, + "InstalledOtherCount": 12, + "InstalledRejectedCount": 0, + "MissingCount": 1, + "FailedCount": 0, + "NotApplicableCount": 675, + "OperationStartTime": 1548438382.462, + "OperationEndTime": 1548438392.176, + "Operation": "Scan" + } + ] } diff --git a/bin/awscli/examples/ssm/describe-instance-patches.rst b/bin/awscli/examples/ssm/describe-instance-patches.rst index 7de9967c..d99d6aa7 100755 --- a/bin/awscli/examples/ssm/describe-instance-patches.rst +++ b/bin/awscli/examples/ssm/describe-instance-patches.rst @@ -1,38 +1,57 @@ -**To get the patch compliance details for an instance** +**To get the patch state details for an instance** -This example gets the patch compliance details for an instance. +This example retrieves information about the patch state details for the specified instance. Command:: - aws ssm describe-instance-patches --instance-id "i-08ee91c0b17045407" + aws ssm describe-instance-patches --instance-id "i-1234567890abcdef0" Output:: { - "NextToken":"--token string truncated--", - "Patches":[ - { - "KBId":"KB2919355", - "Severity":"Critical", - "Classification":"SecurityUpdates", - "Title":"Windows 8.1 Update for x64-based Systems (KB2919355)", - "State":"Installed", - "InstalledTime":"2014-03-18T12:00:00Z" - }, - { - "KBId":"KB2977765", - "Severity":"Important", - "Classification":"SecurityUpdates", - "Title":"Security Update for Microsoft .NET Framework 4.5.1 and 4.5.2 on Windows 8.1 and Windows Server 2012 R2 x64-based Systems (KB2977765)", - "State":"Installed", - "InstalledTime":"2014-10-15T12:00:00Z" - }, - { - "KBId":"KB2978126", - "Severity":"Important", - "Classification":"SecurityUpdates", - "Title":"Security Update for Microsoft .NET Framework 4.5.1 and 4.5.2 on Windows 8.1 (KB2978126)", - "State":"Installed", - "InstalledTime":"2014-11-18T12:00:00Z" - }, - ---output truncated--- + "Patches": [ + { + "Title": "2019-01 Security Update for Adobe Flash Player for Windows Server 2016 for x64-based Systems (KB4480979)", + "KBId": "KB4480979", + "Classification": "SecurityUpdates", + "Severity": "Critical", + "State": "Installed", + "InstalledTime": 1546992000.0 + }, + { + "Title": "", + "KBId": "KB4481031", + "Classification": "", + "Severity": "", + "State": "InstalledOther", + "InstalledTime": 1549584000.0 + }, + ... + ], + "NextToken": "--token string truncated--" + } + +**To get a list of patches in the Missing state for an instance** + +This example retrieves information about patches that are in the Missing state for the specified instance. + +Command:: + + aws ssm describe-instance-patches --instance-id "i-1234567890abcdef0" --filters Key=State,Values=Missing + +Output:: + + { + "Patches": [ + { + "Title": "Windows Malicious Software Removal Tool x64 - February 2019 (KB890830)", + "KBId": "KB890830", + "Classification": "UpdateRollups", + "Severity": "Unspecified", + "State": "Missing", + "InstalledTime": 0.0 + }, + ... + ], + "NextToken": "--token string truncated--" + } diff --git a/bin/awscli/examples/ssm/describe-inventory-deletions.rst b/bin/awscli/examples/ssm/describe-inventory-deletions.rst new file mode 100644 index 00000000..146ce25c --- /dev/null +++ b/bin/awscli/examples/ssm/describe-inventory-deletions.rst @@ -0,0 +1,80 @@ +**To get inventory deletions** + +This example retrieves details for inventory deletion operations. + +Command:: + + aws ssm describe-inventory-deletions + +Output:: + + { + "InventoryDeletions": [ + { + "DeletionId": "6961492a-8163-44ec-aa1e-01234567850", + "TypeName": "Custom:RackInformation", + "DeletionStartTime": 1550254911.0, + "LastStatus": "InProgress", + "LastStatusMessage": "The Delete is in progress", + "DeletionSummary": { + "TotalCount": 0, + "RemainingCount": 0, + "SummaryItems": [] + }, + "LastStatusUpdateTime": 1550254911.0 + }, + { + "DeletionId": "d72ac9e8-1f60-4d40-b1c6-987654321c4d", + "TypeName": "Custom:RackInfo", + "DeletionStartTime": 1550254859.0, + "LastStatus": "InProgress", + "LastStatusMessage": "The Delete is in progress", + "DeletionSummary": { + "TotalCount": 1, + "RemainingCount": 1, + "SummaryItems": [ + { + "Version": "1.0", + "Count": 1, + "RemainingCount": 1 + } + ] + }, + "LastStatusUpdateTime": 1550254859.0 + } + ] + } + +**To get details of a specific inventory deletion** + +This example retrieves details for a specific inventory deletion operation. + +Command:: + + aws ssm describe-inventory-deletions --deletion-id "d72ac9e8-1f60-4d40-b1c6-987654321c4d" + +Output:: + + { + "InventoryDeletions": [ + { + "DeletionId": "d72ac9e8-1f60-4d40-b1c6-987654321c4d", + "TypeName": "Custom:RackInfo", + "DeletionStartTime": 1550254859.0, + "LastStatus": "InProgress", + "LastStatusMessage": "The Delete is in progress", + "DeletionSummary": { + "TotalCount": 1, + "RemainingCount": 1, + "SummaryItems": [ + { + "Version": "1.0", + "Count": 1, + "RemainingCount": 1 + } + ] + }, + "LastStatusUpdateTime": 1550254859.0 + } + ] + } diff --git a/bin/awscli/examples/ssm/describe-maintenance-window-execution-task-invocations.rst b/bin/awscli/examples/ssm/describe-maintenance-window-execution-task-invocations.rst index 400d3860..72aa3392 100755 --- a/bin/awscli/examples/ssm/describe-maintenance-window-execution-task-invocations.rst +++ b/bin/awscli/examples/ssm/describe-maintenance-window-execution-task-invocations.rst @@ -1,6 +1,6 @@ **To get the specific task invocations performed for a task execution** -This example lists the invocations for a task executed as part of a maintenance window execution. +This example lists the invocations for a task executed as part of a Maintenance Window execution. Command:: diff --git a/bin/awscli/examples/ssm/describe-maintenance-window-execution-tasks.rst b/bin/awscli/examples/ssm/describe-maintenance-window-execution-tasks.rst index 40ff96ba..29fa56aa 100755 --- a/bin/awscli/examples/ssm/describe-maintenance-window-execution-tasks.rst +++ b/bin/awscli/examples/ssm/describe-maintenance-window-execution-tasks.rst @@ -1,6 +1,6 @@ **To list all tasks associated with a Maintenance Window Execution** -This example lists the tasks associated with a maintenance window execution. +This example lists the tasks associated with a Maintenance Window execution. Command:: diff --git a/bin/awscli/examples/ssm/describe-maintenance-window-executions.rst b/bin/awscli/examples/ssm/describe-maintenance-window-executions.rst index f12fe500..3bffe856 100755 --- a/bin/awscli/examples/ssm/describe-maintenance-window-executions.rst +++ b/bin/awscli/examples/ssm/describe-maintenance-window-executions.rst @@ -1,6 +1,6 @@ **To list all executions for a Maintenance Window** -This example lists all of the executions for a maintenance window. +This example lists all of the executions for a Maintenance Window. Command:: @@ -20,17 +20,17 @@ Output:: ] } -**To list all executions for a maintenance window before a specified date** +**To list all executions for a Maintenance Window before a specified date** -This example lists all of the executions for a maintenance window before a specific date. +This example lists all of the executions for a Maintenance Window before a specific date. Command:: aws ssm describe-maintenance-window-executions --window-id "mw-ab12cd34ef56gh78" --filters "Key=ExecutedBefore,Values=2016-11-04T05:00:00Z" -**To list all executions for a maintenance window after a specified date** +**To list all executions for a Maintenance Window after a specified date** -This example lists all of the executions for maintenance window after a specific date. +This example lists all of the executions for Maintenance Window after a specific date. Command:: diff --git a/bin/awscli/examples/ssm/describe-maintenance-window-schedule.rst b/bin/awscli/examples/ssm/describe-maintenance-window-schedule.rst new file mode 100644 index 00000000..3e7640e0 --- /dev/null +++ b/bin/awscli/examples/ssm/describe-maintenance-window-schedule.rst @@ -0,0 +1,25 @@ +**To list upcoming executions for a Maintenance Window** + +This example lists upcoming executions for a Maintenance Window. + +Command:: + + aws ssm describe-maintenance-window-schedule --window-id mw-ab12cd34ef56gh78 + +Output:: + + { + "ScheduledWindowExecutions": [ + { + "WindowId": "mw-ab12cd34ef56gh78", + "Name": "My-First-Maintenance-Window", + "ExecutionTime": "2019-02-19T16:00Z" + }, + { + "WindowId": "mw-ab12cd34ef56gh78", + "Name": "My-First-Maintenance-Window", + "ExecutionTime": "2019-02-26T16:00Z" + }, + ... + ] + } \ No newline at end of file diff --git a/bin/awscli/examples/ssm/describe-maintenance-window-targets.rst b/bin/awscli/examples/ssm/describe-maintenance-window-targets.rst index 10c0c7f9..84a6c9b8 100755 --- a/bin/awscli/examples/ssm/describe-maintenance-window-targets.rst +++ b/bin/awscli/examples/ssm/describe-maintenance-window-targets.rst @@ -1,6 +1,6 @@ -**To list all targets for a maintenance window** +**To list all targets for a Maintenance Window** -This example lists all of the targets for a maintenance window. +This example lists all of the targets for a Maintenance Window. Command:: @@ -42,9 +42,9 @@ Output:: ] } -**To list all targets for a maintenance window matching a specific owner information value** +**To list all targets for a Maintenance Window matching a specific owner information value** -This example lists all of the targets for a maintenance window with a specific value. +This example lists all of the targets for a Maintenance Window with a specific value. Command:: diff --git a/bin/awscli/examples/ssm/describe-maintenance-window-tasks.rst b/bin/awscli/examples/ssm/describe-maintenance-window-tasks.rst index 1734f730..5f5421d5 100755 --- a/bin/awscli/examples/ssm/describe-maintenance-window-tasks.rst +++ b/bin/awscli/examples/ssm/describe-maintenance-window-tasks.rst @@ -1,6 +1,6 @@ **To list all tasks for a Maintenance Window** -This example lists all of the tasks for a maintenance window. +This example lists all of the tasks for a Maintenance Window. Command:: @@ -38,25 +38,25 @@ Output:: ] } -**To list all tasks for a maintenance window that invoke the AWS-RunPowerShellScript Run Command** +**To list all tasks for a Maintenance Window that invoke the AWS-RunPowerShellScript Run Command** -This example lists all of the tasks for a maintenance window that invoke the ``AWS-RunPowerShellScript`` Run Command. +This example lists all of the tasks for a Maintenance Window that invoke the ``AWS-RunPowerShellScript`` Run Command. Command:: aws ssm describe-maintenance-window-tasks --window-id "mw-ab12cd34ef56gh78" --filters "Key=TaskArn,Values=AWS-RunPowerShellScript" -**To list all tasks for a maintenance window that have a Priority of 3** +**To list all tasks for a Maintenance Window that have a Priority of 3** -This example lists all of the tasks for a maintenance window that have a ``Priority`` of ``3``. +This example lists all of the tasks for a Maintenance Window that have a ``Priority`` of ``3``. Command:: aws ssm describe-maintenance-window-tasks --window-id "mw-ab12cd34ef56gh78" --filters "Key=Priority,Values=3" -**To list all tasks for a maintenance window that have a Priority of 1 and use Run Command** +**To list all tasks for a Maintenance Window that have a Priority of 1 and use Run Command** -This example lists all of the tasks for a maintenance window that have a ``Priority`` of ``1`` and use ``Run Command``. +This example lists all of the tasks for a Maintenance Window that have a ``Priority`` of ``1`` and use ``Run Command``. Command:: diff --git a/bin/awscli/examples/ssm/describe-maintenance-windows-for-target.rst b/bin/awscli/examples/ssm/describe-maintenance-windows-for-target.rst new file mode 100644 index 00000000..c8d5d3ed --- /dev/null +++ b/bin/awscli/examples/ssm/describe-maintenance-windows-for-target.rst @@ -0,0 +1,18 @@ +**To list all Maintenance Windows associated with a specific instance** + +This example lists the Maintenance Windows which have targets or tasks that the specified instance is asscoiated with. + +Command:: + + aws ssm describe-maintenance-windows-for-target --targets Key=InstanceIds,Values=i-1234567890EXAMPLE --resource-type INSTANCE + +Output:: + + { + "WindowIdentities": [ + { + "WindowId": "mw-0c5ed765acEXAMPLE", + "Name": "My-First-Maintenance-Window" + } + ] + } diff --git a/bin/awscli/examples/ssm/describe-maintenance-windows.rst b/bin/awscli/examples/ssm/describe-maintenance-windows.rst index 0c14c742..e0ceb17e 100755 --- a/bin/awscli/examples/ssm/describe-maintenance-windows.rst +++ b/bin/awscli/examples/ssm/describe-maintenance-windows.rst @@ -1,6 +1,6 @@ -**To list all maintenance windows** +**To list all Maintenance Windows** -This example lists all maintenance windows on your account. +This example lists all Maintenance Windows on your account. Command:: @@ -20,11 +20,19 @@ Output:: ] } -**To list all enabled maintenance windows** +**To list all enabled Maintenance Windows** -This example lists all enabled maintenance windows. +This example lists all enabled Maintenance Windows. Command:: aws ssm describe-maintenance-windows --filters "Key=Enabled,Values=true" + +**To list Maintenance Windows matching a specific name** + +This example lists all Maintenance Windows with a specific name value. + +Command:: + + aws ssm describe-maintenance-windows --filters "Key=Name,Values=MyMaintenanceWindow" \ No newline at end of file diff --git a/bin/awscli/examples/ssm/describe-patch-baselines.rst b/bin/awscli/examples/ssm/describe-patch-baselines.rst index 012fc57c..0647ecdc 100755 --- a/bin/awscli/examples/ssm/describe-patch-baselines.rst +++ b/bin/awscli/examples/ssm/describe-patch-baselines.rst @@ -11,23 +11,20 @@ Output:: { "BaselineIdentities": [ { - "BaselineName": "AWS-DefaultPatchBaseline", - "DefaultBaseline": true, - "BaselineDescription": "Default Patch Baseline Provided by AWS.", - "BaselineId": "arn:aws:ssm:us-west-2:812345678901:patchbaseline/pb-04fb4ae6142167966" + "BaselineId": "arn:aws:ssm:us-east-1:075727635805:patchbaseline/pb-03e3f588eec25344c", + "BaselineName": "AWS-CentOSDefaultPatchBaseline", + "OperatingSystem": "CENTOS", + "BaselineDescription": "Default Patch Baseline for CentOS Provided by AWS.", + "DefaultBaseline": true }, { - "BaselineName": "Production-Baseline", - "DefaultBaseline": false, - "BaselineDescription": "Baseline containing all updates approved for production systems", - "BaselineId": "pb-045f10b4f382baeda" + "BaselineId": "arn:aws:ssm:us-east-1:075727635805:patchbaseline/pb-07d8884178197b66b", + "BaselineName": "AWS-SuseDefaultPatchBaseline", + "OperatingSystem": "SUSE", + "BaselineDescription": "Default Patch Baseline for Suse Provided by AWS.", + "DefaultBaseline": true }, - { - "BaselineName": "Production-Baseline", - "DefaultBaseline": false, - "BaselineDescription": "Baseline containing all updates approved for production systems", - "BaselineId": "pb-0a2f1059b670ebd31" - } + ... ] } diff --git a/bin/awscli/examples/ssm/describe-patch-group-state.rst b/bin/awscli/examples/ssm/describe-patch-group-state.rst index 926cd665..d765cc2e 100755 --- a/bin/awscli/examples/ssm/describe-patch-group-state.rst +++ b/bin/awscli/examples/ssm/describe-patch-group-state.rst @@ -9,10 +9,11 @@ Command:: Output:: { - "InstancesWithNotApplicablePatches": 0, - "InstancesWithMissingPatches": 0, - "InstancesWithFailedPatches": 1, - "InstancesWithInstalledOtherPatches": 4, - "Instances": 4, - "InstancesWithInstalledPatches": 3 + "Instances": 2, + "InstancesWithInstalledPatches": 2, + "InstancesWithInstalledOtherPatches": 2, + "InstancesWithInstalledRejectedPatches": 0, + "InstancesWithMissingPatches": 2, + "InstancesWithFailedPatches": 0, + "InstancesWithNotApplicablePatches": 2 } diff --git a/bin/awscli/examples/ssm/describe-patch-groups.rst b/bin/awscli/examples/ssm/describe-patch-groups.rst index f7e00a08..699dc39f 100755 --- a/bin/awscli/examples/ssm/describe-patch-groups.rst +++ b/bin/awscli/examples/ssm/describe-patch-groups.rst @@ -13,11 +13,23 @@ Output:: { "PatchGroup": "Production", "BaselineIdentity": { - "BaselineName": "Production-Baseline", - "DefaultBaseline": false, - "BaselineDescription": "Baseline containing all updates approved for production systems", - "BaselineId": "pb-045f10b4f382baeda" + "BaselineId": "pb-0123456789abcdef0", + "BaselineName": "ProdPatching", + "OperatingSystem": "WINDOWS", + "BaselineDescription": "Patches for Production", + "DefaultBaseline": false } - } + }, + { + "PatchGroup": "Development", + "BaselineIdentity": { + "BaselineId": "pb-0713accee01234567", + "BaselineName": "DevPatching", + "OperatingSystem": "WINDOWS", + "BaselineDescription": "Patches for Development", + "DefaultBaseline": true + } + }, + ... ] } diff --git a/bin/awscli/examples/ssm/describe-sessions.rst b/bin/awscli/examples/ssm/describe-sessions.rst new file mode 100644 index 00000000..788441f5 --- /dev/null +++ b/bin/awscli/examples/ssm/describe-sessions.rst @@ -0,0 +1,64 @@ +**To list all active Session Manager sessions** + +This example retrieves a list of the active sessions created most recently (both connected and disconnected sessions) over the past 30 days that were started by a particular user. + +Command:: + + aws ssm describe-sessions --state "Active" --filters "key=Owner,value=arn:aws:sts::123456789012:assumed-role/Administrator/Matt" + +Output:: + + { + "Sessions": [ + { + "SessionId": "Matt-07a16060613c408b5", + "Target": "i-1234567890abcdef0", + "Status": "Connected", + "StartDate": 1550676938.352, + "Owner": "arn:aws:sts::123456789012:assumed-role/Administrator/Matt", + "OutputUrl": {} + }, + { + "SessionId": "Matt-01edf534b8b56e8eb", + "Target": "i-9876543210abcdef0", + "Status": "Connected", + "StartDate": 1550676842.194, + "Owner": "arn:aws:sts::123456789012:assumed-role/Administrator/Matt", + "OutputUrl": {} + } + ] + } + +**To list all terminated Session Manager sessions** + +This example retrieves a list of the most recently terminated sessions from the past 30 days for all users. + +Command:: + + aws ssm describe-sessions --state "History" + +Output:: + + { + "Sessions": [ + { + "SessionId": "Dan-0022b1eb2b0d9e3bd", + "Target": "i-1234567890abcdef0", + "Status": "Terminated", + "StartDate": 1550520701.256, + "EndDate": 1550521931.563, + "Owner": "arn:aws:sts::123456789012:assumed-role/Administrator/Dan" + }, + { + "SessionId": "Erik-0db53f487931ed9d4", + "Target": "i-9876543210abcdef0", + "Status": "Terminated", + "StartDate": 1550161369.149, + "EndDate": 1550162580.329, + "Owner": "arn:aws:sts::123456789012:assumed-role/Administrator/Erik" + }, + ... + ], + "NextToken": "--token string truncated--" + } + \ No newline at end of file diff --git a/bin/awscli/examples/ssm/get-command-invocation.rst b/bin/awscli/examples/ssm/get-command-invocation.rst index 8628cef9..fb92bff4 100755 --- a/bin/awscli/examples/ssm/get-command-invocation.rst +++ b/bin/awscli/examples/ssm/get-command-invocation.rst @@ -4,21 +4,28 @@ This example lists all the invocations of a command on an instance. Command:: - aws ssm get-command-invocation --command-id "bca3371c-3fdf-43f1-9323-7a7780b1b4db" --instance-id "i-0000293ffd8c57862" + aws ssm get-command-invocation --command-id "ef7fdfd8-9b57-4151-a15c-db9a12345678" --instance-id "i-1234567890abcdef0" Output:: { - "Comment": "Apply association with id at creation time: a052fd99-0852-4df2-ad69-0299f2c82047", - "Status": "SUCCESS", - "ExecutionEndDateTime": "", - "StandardErrorContent": "", - "InstanceId": "i-0000293ffd8c57862", - "StandardErrorUrl": "", - "DocumentName": "AWS-RefreshAssociation", - "StandardOutputContent": "", - "PluginName": "", - "ResponseCode": -1, - "CommandId": "bca3371c-3fdf-43f1-9323-7a7780b1b4db", - "StandardOutputUrl": "" + "CommandId": "ef7fdfd8-9b57-4151-a15c-db9a12345678", + "InstanceId": "i-1234567890abcdef0", + "Comment": "", + "DocumentName": "AWS-RunPowerShellScript", + "DocumentVersion": "1", + "PluginName": "aws:runPowerShellScript", + "ResponseCode": 0, + "ExecutionStartDateTime": "2019-02-14T19:26:26.439Z", + "ExecutionElapsedTime": "PT0.541S", + "ExecutionEndDateTime": "2019-02-14T19:26:26.439Z", + "Status": "Success", + "StatusDetails": "Success", + "StandardOutputContent": "HelloWorld\r\n", + "StandardOutputUrl": "", + "StandardErrorContent": "", + "StandardErrorUrl": "", + "CloudWatchOutputConfig": { + "CloudWatchLogGroupName": "", + "CloudWatchOutputEnabled": false } diff --git a/bin/awscli/examples/ssm/get-connection-status.rst b/bin/awscli/examples/ssm/get-connection-status.rst new file mode 100644 index 00000000..fd79f8c6 --- /dev/null +++ b/bin/awscli/examples/ssm/get-connection-status.rst @@ -0,0 +1,14 @@ +**To display the connection status of a managed instance** + +This example returns the connection status of the managed instance ``i-1234567890abcdef0``. + +Command:: + + aws ssm get-connection-status --target i-1234567890abcdef0 + +Output:: + + { + "Target": "i-1234567890abcdef0", + "Status": "connected" + } diff --git a/bin/awscli/examples/ssm/get-default-patch-baseline.rst b/bin/awscli/examples/ssm/get-default-patch-baseline.rst index 640b902b..cf6ccd68 100755 --- a/bin/awscli/examples/ssm/get-default-patch-baseline.rst +++ b/bin/awscli/examples/ssm/get-default-patch-baseline.rst @@ -1,6 +1,6 @@ -**To display the default patch baseline** +**To display the default Windows patch baseline** -This example displays the default patch baseline. +This example displays the default Windows patch baseline. Command:: @@ -9,5 +9,21 @@ Command:: Output:: { - "BaselineId":"arn:aws:ssm:us-west-1:812345678901:patchbaseline/pb-0ca44a362f8afc725" + "BaselineId": "pb-0713accee01612345", + "OperatingSystem": "WINDOWS" + } + +**To display the default Amazon Linux patch baseline** + +This example displays the default Windows patch baseline. + +Command:: + + aws ssm get-default-patch-baseline --operating-system AMAZON_LINUX + +Output:: + + { + "BaselineId": "pb-047c6eb9c8fc12345", + "OperatingSystem": "AMAZON_LINUX" } diff --git a/bin/awscli/examples/ssm/get-deployable-patch-snapshot-for-instance.rst b/bin/awscli/examples/ssm/get-deployable-patch-snapshot-for-instance.rst index 39843675..91808f7f 100755 --- a/bin/awscli/examples/ssm/get-deployable-patch-snapshot-for-instance.rst +++ b/bin/awscli/examples/ssm/get-deployable-patch-snapshot-for-instance.rst @@ -6,12 +6,13 @@ Use ``uuidgen`` to generate a ``snapshot-id``. Command:: - aws ssm get-deployable-patch-snapshot-for-instance --instance-id "i-0cb2b964d3e14fd9f" --snapshot-id "4681775b-098f-4435-a956-0ef33373ac11" + aws ssm get-deployable-patch-snapshot-for-instance --instance-id "i-1234567890abcdef0" --snapshot-id "521c3536-930c-4aa9-950e-01234567abcd" Output:: { - "InstanceId": "i-0cb2b964d3e14fd9f", - "SnapshotId": "4681775b-098f-4435-a956-0ef33373ac11", - "SnapshotDownloadUrl": "https://patch-baseline-snapshot-us-west-2.s3-us-west-2.amazonaws.com/853d0d3db0f0cafea3699f25b1c7ff101a13e25c3d05e832f613b0d2f79da62f-809632081692/4681775b-098f-4435-a956-0ef33373ac11?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20170224T181926Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86400&X-Amz-Credential=AKIAJI6YDVV7XJKZL7ZA%2F20170224%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=2747799c958ffebf6f44bd698fd2071ccf9a303465febfab71ff29b46631a2d3" + "InstanceId": "i-1234567890abcdef0", + "SnapshotId": "521c3536-930c-4aa9-950e-01234567abcd", + "Product": "AmazonLinux2018.03", + "SnapshotDownloadUrl": "https://patch-baseline-snapshot-us-east-1.s3.amazonaws.com/ed85194ef27214f5984f28b4d664d14f7313568fea7d4b6ac6c10ad1f729d7e7-773304212436/AMAZON_LINUX-521c3536-930c-4aa9-950e-01234567abcd?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20190215T164031Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86400&X-Amz-Credential=AKIAJ5C56P35AEBRX2QQ%2F20190215%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=efaaaf6e3878e77f48a6697e015efdbda9c426b09c5822055075c062f6ad2149" } diff --git a/bin/awscli/examples/ssm/get-document.rst b/bin/awscli/examples/ssm/get-document.rst index 5967e934..0622fff5 100644 --- a/bin/awscli/examples/ssm/get-document.rst +++ b/bin/awscli/examples/ssm/get-document.rst @@ -14,3 +14,22 @@ Output:: "DocumentVersion": "1", "DocumentType": "Command" } + +**To get the contents of a document in YAML format** + +This example returns the content of a document in YAML format. + +Command:: + + aws ssm get-document --name "RunShellScript" --document-format YAML + +Output:: + + { + "Name": "A-Document-yaml2", + "DocumentVersion": "1", + "Status": "Active", + "Content": "---\nschemaVersion: '1.2'\ndescription: Run a PowerShell script or specify the paths to scripts to run.\nparameters:\n commands:\n type: StringList\n description: \"(Required) Specify the commands to run or the paths to existing\n scripts on the instance.\"\n minItems: 1\n displayType: textarea\n workingDirectory:\n type: String\n default: ''\n description: \"(Optional) The path to the working directory on your instance.\"\n maxChars: 4096\n executionTimeout:\n type: String\n default: '3600'\n description: \"(Optional) The time in seconds for a command to be completed before\n it is considered to have failed. Default is 3600 (1 hour). Maximum is 172800\n (48 hours).\"\n allowedPattern: \"([1-9][0-9]{0,4})|(1[0-6][0-9]{4})|(17[0-1][0-9]{3})|(172[0-7][0-9]{2})|(172800)\"\nruntimeConfig:\n aws:runPowerShellScript:\n properties:\n - id: 0.aws:runPowerShellScript\n runCommand: \"{{ commands }}\"\n workingDirectory: \"{{ workingDirectory }}\"\n timeoutSeconds: \"{{ executionTimeout }}\"\n", + "DocumentType": "Command", + "DocumentFormat": "YAML" + } \ No newline at end of file diff --git a/bin/awscli/examples/ssm/get-inventory-schema.rst b/bin/awscli/examples/ssm/get-inventory-schema.rst index 9307263b..1e3547ef 100755 --- a/bin/awscli/examples/ssm/get-inventory-schema.rst +++ b/bin/awscli/examples/ssm/get-inventory-schema.rst @@ -15,35 +15,44 @@ Output:: "Version": "1.0", "Attributes": [ { - "DataType": "STRING", - "Name": "Name" + "Name": "Name", + "DataType": "STRING" }, { - "DataType": "STRING", - "Name": "ApplicationType" + "Name": "ApplicationType", + "DataType": "STRING" }, { - "DataType": "STRING", - "Name": "Publisher" + "Name": "Publisher", + "DataType": "STRING" }, { - "DataType": "STRING", - "Name": "Version" + "Name": "Version", + "DataType": "STRING" }, { - "DataType": "STRING", - "Name": "InstalledTime" + "Name": "InstalledTime", + "DataType": "STRING" }, { - "DataType": "STRING", - "Name": "Architecture" + "Name": "Architecture", + "DataType": "STRING" }, { - "DataType": "STRING", - "Name": "URL" + "Name": "URL", + "DataType": "STRING" } ] }, ... - } - } \ No newline at end of file + ], + "NextToken": "--token string truncated--" + } + +**To view the inventory schema for a specific inventory type** + +This example return the inventory schema for a the AWS:AWSComponent inventory type. + +Command:: + + aws ssm get-inventory-schema --type-name "AWS:AWSComponent" diff --git a/bin/awscli/examples/ssm/get-maintenance-window-execution-task-invocation.rst b/bin/awscli/examples/ssm/get-maintenance-window-execution-task-invocation.rst new file mode 100644 index 00000000..fcfd07b8 --- /dev/null +++ b/bin/awscli/examples/ssm/get-maintenance-window-execution-task-invocation.rst @@ -0,0 +1,22 @@ +**To get information about a Maintenance Window task invocation** + +This example lists information about a task invocation that was part of a Maintenance Window execution. + +Command:: + + aws ssm get-maintenance-window-execution-task-invocation --window-execution-id "bc494bfa-e63b-49f6-8ad1-aa9f2EXAMPLE" --task-id "96f2ad59-97e3-461d-a63d-40c8aEXAMPLE" --invocation-id "a5273e2c-d2c6-4880-b3e1-5e550EXAMPLE" + +Output:: + + { + "Status": "SUCCESS", + "Parameters": "{\"comment\":\"\",\"documentName\":\"AWS-RunPowerShellScript\",\"instanceIds\":[\"i-1234567890EXAMPLE\"],\"maxConcurrency\":\"1\",\"maxErrors\":\"1\",\"parameters\":{\"executionTimeout\":[\"3600\"],\"workingDirectory\":[\"\"],\"commands\":[\"echo Hello\"]},\"timeoutSeconds\":600}", + "ExecutionId": "03b6baa0-5460-4e15-83f2-ea685EXAMPLE", + "InvocationId": "a5273e2c-d2c6-4880-b3e1-5e550EXAMPLE", + "StartTime": 1549998326.421, + "TaskType": "RUN_COMMAND", + "EndTime": 1550001931.784, + "WindowExecutionId": "bc494bfa-e63b-49f6-8ad1-aa9f2EXAMPLE", + "StatusDetails": "Failed", + "TaskExecutionId": "96f2ad59-97e3-461d-a63d-40c8aEXAMPLE" + } diff --git a/bin/awscli/examples/ssm/get-maintenance-window-execution-task.rst b/bin/awscli/examples/ssm/get-maintenance-window-execution-task.rst index 2adfd75a..65dba778 100755 --- a/bin/awscli/examples/ssm/get-maintenance-window-execution-task.rst +++ b/bin/awscli/examples/ssm/get-maintenance-window-execution-task.rst @@ -1,6 +1,6 @@ **To get information about a Maintenance Window task execution** -This example lists information about a task that was part of a maintenance window execution. +This example lists information about a task that was part of a Maintenance Window execution. Command:: diff --git a/bin/awscli/examples/ssm/get-maintenance-window-execution.rst b/bin/awscli/examples/ssm/get-maintenance-window-execution.rst index e48637ef..d648dd11 100755 --- a/bin/awscli/examples/ssm/get-maintenance-window-execution.rst +++ b/bin/awscli/examples/ssm/get-maintenance-window-execution.rst @@ -1,6 +1,6 @@ **To get information about a Maintenance Window task execution** -This example lists information about a task executed as part of a maintenance window execution. +This example lists information about a task executed as part of a Maintenance Window execution. Command:: diff --git a/bin/awscli/examples/ssm/get-maintenance-window-task.rst b/bin/awscli/examples/ssm/get-maintenance-window-task.rst new file mode 100644 index 00000000..af00af07 --- /dev/null +++ b/bin/awscli/examples/ssm/get-maintenance-window-task.rst @@ -0,0 +1,47 @@ +**To get information about a Maintenance Window task** + +This example gets details about a Maintenance Window task. + +Command:: + + aws ssm get-maintenance-window-task --window-id mw-0c5ed765acEXAMPLE --window-task-id 0e842a8d-2d44-4886-bb62-af8dcEXAMPLE + +Output:: + + { + "ServiceRoleArn": "arn:aws:iam::111222333444:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM", + "MaxErrors": "1", + "TaskArn": "AWS-RunPowerShellScript", + "MaxConcurrency": "1", + "WindowTaskId": "0e842a8d-2d44-4886-bb62-af8dcEXAMPLE", + "TaskParameters": {}, + "Priority": 1, + "TaskInvocationParameters": { + "RunCommand": { + "Comment": "", + "TimeoutSeconds": 600, + "Parameters": { + "commands": [ + "echo Hello" + ], + "executionTimeout": [ + "3600" + ], + "workingDirectory": [ + "" + ] + } + } + }, + "WindowId": "mw-0c5ed765acEXAMPLE", + "TaskType": "RUN_COMMAND", + "Targets": [ + { + "Values": [ + "84c818da-b619-4d3d-9651-946f3EXAMPLE" + ], + "Key": "WindowTargetIds" + } + ], + "Name": "ExampleTask" + } diff --git a/bin/awscli/examples/ssm/get-maintenance-window.rst b/bin/awscli/examples/ssm/get-maintenance-window.rst index 6eeeb41a..def19c80 100755 --- a/bin/awscli/examples/ssm/get-maintenance-window.rst +++ b/bin/awscli/examples/ssm/get-maintenance-window.rst @@ -1,6 +1,6 @@ -**To get information about a maintenance window** +**To get information about a Maintenance Window** -This example gets details about a maintenance window. +This example gets details about a Maintenance Window. Command:: diff --git a/bin/awscli/examples/ssm/get-parameter-history.rst b/bin/awscli/examples/ssm/get-parameter-history.rst index 6aaaf84a..d6a02152 100755 --- a/bin/awscli/examples/ssm/get-parameter-history.rst +++ b/bin/awscli/examples/ssm/get-parameter-history.rst @@ -11,11 +11,13 @@ Output:: { "Parameters": [ { - "LastModifiedUser": "arn:aws:iam::812345678901:user/admin", - "LastModifiedDate": 1487880053.085, - "Type": "String", "Name": "welcome", - "Value": "helloWorld" + "Type": "String", + "LastModifiedDate": 1542308384.49, + "LastModifiedUser": "arn:aws:sts::123456789012:assumed-role/Administrator", + "Value": "1", + "Version": 1, + "Labels": [] } ] } diff --git a/bin/awscli/examples/ssm/get-parameter.rst b/bin/awscli/examples/ssm/get-parameter.rst new file mode 100644 index 00000000..8501f56d --- /dev/null +++ b/bin/awscli/examples/ssm/get-parameter.rst @@ -0,0 +1,43 @@ +**Example 1: To list the value for a parameter** + +The following ``get-parameter`` example lists the value for a parameter. + +Command:: + + aws ssm get-parameter --name "helloWorld" + +Output:: + + { + "Parameter": { + "Name": "helloWorld", + "Type": "String", + "Value": "Good day sunshine", + "Version": 1, + "LastModifiedDate": 1530018761.888, + "ARN": "arn:aws:ssm:us-east-1:123456789012:parameter/helloWorld" + } + } + +**Example 2: To decrypt the value for a parmeter** + +The following ``get-parameter`` example decrypts the value of a ``SecureString`` parameter. + +Command:: + + aws ssm get-parameter \ + --name "helloSecureWorld" \ + --with-decryption + +Output:: + + { + "Parameter": { + "Name": "helloSecureWorld", + "Type": "SecureString", + "Value": "Good day sunshine", + "Version": 1, + "LastModifiedDate": 1530018761.888, + "ARN": "arn:aws:ssm:us-east-1:123456789012:parameter/helloSecureWorld" + } + } diff --git a/bin/awscli/examples/ssm/get-parameters-by-path.rst b/bin/awscli/examples/ssm/get-parameters-by-path.rst new file mode 100644 index 00000000..72c1bfbe --- /dev/null +++ b/bin/awscli/examples/ssm/get-parameters-by-path.rst @@ -0,0 +1,31 @@ +**To list parameters in a specific path** + +This example lists parameters within a specific hierarchy. + +Command:: + + aws ssm get-parameters-by-path --path "/site/newyork/department/" + +Output:: + + { + "Parameters": [ + { + "Name": "/site/newyork/department/marketing", + "Type": "String", + "Value": "Floor 2", + "Version": 1, + "LastModifiedDate": 1530018761.888, + "ARN": "arn:aws:ssm:us-east-1:123456789012:parameter/site/newyork/department/marketing" + }, + { + "Name": "/site/newyork/department/infotech", + "Type": "String", + "Value": "Floor 3", + "Version": 1, + "LastModifiedDate": 1530018823.429, + "ARN": "arn:aws:ssm:us-east-1:123456789012:parameter//site/newyork/department/infotech" + }, + ... + ] + } diff --git a/bin/awscli/examples/ssm/get-parameters.rst b/bin/awscli/examples/ssm/get-parameters.rst index 0f5a4000..c3cfc739 100755 --- a/bin/awscli/examples/ssm/get-parameters.rst +++ b/bin/awscli/examples/ssm/get-parameters.rst @@ -9,14 +9,17 @@ Command:: Output:: { - "InvalidParameters": [], - "Parameters": [ - { - "Type": "String", - "Name": "helloWorld", - "Value": "good day sunshine" - } - ] + "Parameters": [ + { + "Name": "helloWorld", + "Type": "String", + "Value": "good day sunshine", + "Version": 1, + "LastModifiedDate": 1542308384.49, + "ARN": "arn:aws:ssm:us-east-1:123456789012:parameter/helloWorld" + } + ], + "InvalidParameters": [] } To list the name and value of multiple parameters the --query argument can be used with a list of names. diff --git a/bin/awscli/examples/ssm/get-patch-baseline-for-patch-group.rst b/bin/awscli/examples/ssm/get-patch-baseline-for-patch-group.rst index 9c13f545..fa6fadf2 100755 --- a/bin/awscli/examples/ssm/get-patch-baseline-for-patch-group.rst +++ b/bin/awscli/examples/ssm/get-patch-baseline-for-patch-group.rst @@ -4,11 +4,12 @@ This example displays the patch baseline for a patch group. Command:: - aws ssm get-patch-baseline-for-patch-group --patch-group "Production" + aws ssm get-patch-baseline-for-patch-group --patch-group "DEV" Output:: { - "PatchGroup": "Production", - "BaselineId": "pb-045f10b4f382baeda" + "BaselineId": "pb-0123456789abcdef0", + "PatchGroup": "DEV", + "OperatingSystem": "WINDOWS" } diff --git a/bin/awscli/examples/ssm/get-patch-baseline.rst b/bin/awscli/examples/ssm/get-patch-baseline.rst index 9683b4ba..68b61223 100755 --- a/bin/awscli/examples/ssm/get-patch-baseline.rst +++ b/bin/awscli/examples/ssm/get-patch-baseline.rst @@ -4,58 +4,47 @@ This example displays the details for a patch baseline. Command:: - aws ssm get-patch-baseline --baseline-id "pb-00dbb759999aa2bc3" + aws ssm get-patch-baseline --baseline-id "pb-0123456789abcdef0" Output:: { - "BaselineId":"pb-00dbb759999aa2bc3", - "Name":"Windows-Server-2012R2", - "PatchGroups":[ - "Web Servers" - ], - "RejectedPatches":[ - - ], - "GlobalFilters":{ - "PatchFilters":[ - - ] - }, - "ApprovalRules":{ - "PatchRules":[ - { - "PatchFilterGroup":{ - "PatchFilters":[ - { - "Values":[ - "Important", - "Critical" - ], - "Key":"MSRC_SEVERITY" - }, - { - "Values":[ - "SecurityUpdates" - ], - "Key":"CLASSIFICATION" - }, - { - "Values":[ - "WindowsServer2012R2" - ], - "Key":"PRODUCT" - } - ] - }, - "ApproveAfterDays":5 - } - ] - }, - "ModifiedDate":1480997823.81, - "CreatedDate":1480997823.81, - "ApprovedPatches":[ - - ], - "Description":"Windows Server 2012 R2, Important and Critical security updates" + "BaselineId": "pb-0123456789abcdef0", + "Name": "WindowsPatching", + "OperatingSystem": "WINDOWS", + "GlobalFilters": { + "PatchFilters": [] + }, + "ApprovalRules": { + "PatchRules": [ + { + "PatchFilterGroup": { + "PatchFilters": [ + { + "Key": "PRODUCT", + "Values": [ + "WindowsServer2016" + ] + } + ] + }, + "ComplianceLevel": "CRITICAL", + "ApproveAfterDays": 0, + "EnableNonSecurity": false + } + ] + }, + "ApprovedPatches": [], + "ApprovedPatchesComplianceLevel": "UNSPECIFIED", + "ApprovedPatchesEnableNonSecurity": false, + "RejectedPatches": [], + "RejectedPatchesAction": "ALLOW_AS_DEPENDENCY", + "PatchGroups": [ + "QA", + "DEV" + ], + "CreatedDate": 1550244180.465, + "ModifiedDate": 1550244180.465, + "Description": "Patches for Windows Servers", + "Sources": [] } diff --git a/bin/awscli/examples/ssm/get-service-setting.rst b/bin/awscli/examples/ssm/get-service-setting.rst new file mode 100644 index 00000000..b43ddec0 --- /dev/null +++ b/bin/awscli/examples/ssm/get-service-setting.rst @@ -0,0 +1,21 @@ +**To retrieve the service setting for Parameter Store throughput** + +The following ``get-service-setting`` This example retrieves the current service setting for Parameter Store throughput in the specified region. :: + + aws ssm get-service-setting \ + --setting-id arn:aws:ssm:us-east-1:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled + +Output:: + + { + "ServiceSetting": { + "SettingId": "/ssm/parameter-store/high-throughput-enabled", + "SettingValue": "false", + "LastModifiedDate": 1555532818.578, + "LastModifiedUser": "System", + "ARN": "arn:aws:ssm:us-east-1:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled", + "Status": "Default" + } + } + +For more information, see `Increasing Parameter Store Throughput `_ in the *AWS Systems Manager Users Guide*. diff --git a/bin/awscli/examples/ssm/label-parameter-version.rst b/bin/awscli/examples/ssm/label-parameter-version.rst new file mode 100644 index 00000000..388408e8 --- /dev/null +++ b/bin/awscli/examples/ssm/label-parameter-version.rst @@ -0,0 +1,21 @@ +**To add a label to latest version of a parameter** + +This example adds a label to the latest version of a parameter. + +Command:: + + aws ssm label-parameter-version --name "softwareversion" --labels "DevelopmentReady" + +Output:: + + { + "InvalidLabels": [] + } + +**To add a label to a specific version of a parameter** + +This example adds a label to the specified version of a parameter. + +Command:: + + aws ssm label-parameter-version --name "softwareversion" --parameter-version "2" --labels "ProductionReady" diff --git a/bin/awscli/examples/ssm/list-association-versions.rst b/bin/awscli/examples/ssm/list-association-versions.rst new file mode 100644 index 00000000..0bcc23c1 --- /dev/null +++ b/bin/awscli/examples/ssm/list-association-versions.rst @@ -0,0 +1,38 @@ +**To list all versions of an association for a specific association ID** + +This example lists all versions of the specified associations. + +Command:: + + aws ssm list-association-versions --association-id "8dfe3659-4309-493a-8755-0123456789ab" + +Output:: + + { + "AssociationVersions": [ + { + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", + "AssociationVersion": "1", + "CreatedDate": 1550505536.726, + "Name": "AWS-UpdateSSMAgent", + "Parameters": { + "allowDowngrade": [ + "false" + ], + "version": [ + "" + ] + }, + "Targets": [ + { + "Key": "InstanceIds", + "Values": [ + "i-1234567890abcdef0" + ] + } + ], + "ScheduleExpression": "cron(0 00 12 ? * SUN *)", + "AssociationName": "UpdateSSMAgent" + } + ] + } diff --git a/bin/awscli/examples/ssm/list-associations.rst b/bin/awscli/examples/ssm/list-associations.rst index dfb31b31..2aa5d88d 100644 --- a/bin/awscli/examples/ssm/list-associations.rst +++ b/bin/awscli/examples/ssm/list-associations.rst @@ -4,14 +4,25 @@ This example lists all the associations for an instance. Command:: - aws ssm list-associations --association-filter-list "key=InstanceId,value=i-0000293ffd8c57862" + aws ssm list-associations --association-filter-list "key=InstanceId,value=i-1234567890abcdef0" Output:: { "Associations": [ { - "InstanceId": "i-0000293ffd8c57862", + "Name": "AWS-UpdateSSMAgent", + "InstanceId": "i-1234567890abcdef0", + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", + "AssociationVersion": "1", + "Targets": [ + { + "Key": "InstanceIds", + "Values": [ + "i-016648b75dd622dab" + ] + } + ], "Overview": { "Status": "Pending", "DetailedStatus": "Associated", @@ -19,23 +30,15 @@ Output:: "Pending": 1 } }, - "AssociationId": "d8617c07-2079-4c18-9847-1655fc2698b0", - "Name": "AWS-UpdateSSMAgent", - "Targets": [ - { - "Values": [ - "i-0000293ffd8c57862" - ], - "Key": "InstanceIds" - } - ] + "ScheduleExpression": "cron(0 00 12 ? * SUN *)", + "AssociationName": "UpdateSSMAgent" } ] } **To list your associations for a specific document** -This example lists all associations for the a document. +This example lists all associations for the specified document. Command:: @@ -46,44 +49,49 @@ Output:: { "Associations": [ { - "InstanceId": "i-0000293ffd8c57862", - "Overview": { - "Status": "Pending", - "DetailedStatus": "Associated", - "AssociationStatusAggregatedCount": { - "Pending": 1 - } - }, - "AssociationId": "d8617c07-2079-4c18-9847-1655fc2698b0", "Name": "AWS-UpdateSSMAgent", + "InstanceId": "i-1234567890abcdef0", + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", + "AssociationVersion": "1", "Targets": [ { + "Key": "InstanceIds", "Values": [ - "i-0000293ffd8c57862" - ], - "Key": "InstanceIds" + "i-1234567890abcdef0" + ] } - ] - }, - { - "Name": "AWS-UpdateSSMAgent", - "LastExecutionDate": 1487876123.0, - "InstanceId": "i-0cb2b964d3e14fd9f", + ], + "LastExecutionDate": 1550505828.548, "Overview": { "Status": "Success", + "DetailedStatus": "Success", "AssociationStatusAggregatedCount": { "Success": 1 } }, - "AssociationId": "2ccfbc46-5fe4-4e5c-ba46-70b56cc93f53", + "ScheduleExpression": "cron(0 00 12 ? * SUN *)", + "AssociationName": "UpdateSSMAgent" + }, + { + "Name": "AWS-UpdateSSMAgent", + "InstanceId": "i-9876543210abcdef0", + "AssociationId": "fbc07ef7-b985-4684-b82b-0123456789ab", + "AssociationVersion": "1", "Targets": [ { + "Key": "InstanceIds", "Values": [ - "i-0cb2b964d3e14fd9f" - ], - "Key": "InstanceIds" + "i-9876543210abcdef0" + ] + } + ], + "LastExecutionDate": 1550507531.0, + "Overview": { + "Status": "Success", + "AssociationStatusAggregatedCount": { + "Success": 1 } - ] + } } ] } diff --git a/bin/awscli/examples/ssm/list-command-invocations.rst b/bin/awscli/examples/ssm/list-command-invocations.rst index 922f38e9..8cbc3c83 100755 --- a/bin/awscli/examples/ssm/list-command-invocations.rst +++ b/bin/awscli/examples/ssm/list-command-invocations.rst @@ -4,45 +4,89 @@ This example lists all the invocations of a command. Command:: - aws ssm list-command-invocations --command-id "b8eac879-0541-439d-94ec-47a80d554f44" --details + aws ssm list-command-invocations --command-id "ef7fdfd8-9b57-4151-a15c-db9a12345678" --details Output:: { "CommandInvocations": [ - { - "Comment": "IP config", - "Status": "Success", - "CommandPlugins": [ - { - "Status": "Success", - "ResponseStartDateTime": 1487794396.651, - "StandardErrorUrl": "", - "OutputS3BucketName": "", - "OutputS3Region": "us-west-2", - "OutputS3KeyPrefix": "", - "ResponseCode": 0, - "Output": "eth0 Link encap:Ethernet HWaddr 06:41:38:F5:D6:EF \n inet addr:172.31.44.222 Bcast:172.31.47.255 Mask:255.255.240.0\n inet6 addr: fe80::441:38ff:fef5:d6ef/64 Scope:Link\n UP BROADCAST RUNNING MULTICAST MTU:9001 Metric:1\n RX packets:186705 errors:0 dropped:0 overruns:0 frame:0\n TX packets:188811 errors:0 dropped:0 overruns:0 carrier:0\n collisions:0 txqueuelen:1000 \n RX bytes:91749280 (87.4 MiB) TX bytes:31721645 (30.2 MiB)\n\nlo Link encap:Local Loopback \n inet addr:127.0.0.1 Mask:255.0.0.0\n inet6 addr: ::1/128 Scope:Host\n UP LOOPBACK RUNNING MTU:65536 Metric:1\n RX packets:2 errors:0 dropped:0 overruns:0 frame:0\n X packets:2 errors:0 dropped:0 overruns:0 carrier:0\n collisions:0 txqueuelen:1 \n RX bytes:140 (140.0 b) TX bytes:140 (140.0 b)\n\n", - "ResponseFinishDateTime": 1487794396.655, - "StatusDetails": "Success", - "StandardOutputUrl": "", - "Name": "aws:runShellScript" - } - ], - "ServiceRole": "", - "InstanceId": "i-0cb2b964d3e14fd9f", - "DocumentName": "AWS-RunShellScript", - "NotificationConfig": { - "NotificationArn": "", - "NotificationEvents": [], - "NotificationType": "" - }, - "StatusDetails": "Success", - "StandardOutputUrl": "", - "StandardErrorUrl": "", - "InstanceName": "", - "CommandId": "b8eac879-0541-439d-94ec-47a80d554f44", - "RequestedDateTime": 1487794396.363 - } - ] + { + "CommandId": "ef7fdfd8-9b57-4151-a15c-db9a12345678", + "InstanceId": "i-1234567890abcdef0", + "InstanceName": "", + "Comment": "", + "DocumentName": "AWS-RunPowerShellScript", + "DocumentVersion": "1", + "RequestedDateTime": 1550172741.988, + "Status": "Success", + "StatusDetails": "Success", + "StandardOutputUrl": "", + "StandardErrorUrl": "", + "CommandPlugins": [ + { + "Name": "aws:runPowerShellScript", + "Status": "Success", + "StatusDetails": "Success", + "ResponseCode": 0, + "ResponseStartDateTime": 1550172742.696, + "ResponseFinishDateTime": 1550172743.245, + "Output": "HelloWorld\r\n", + "StandardOutputUrl": "", + "StandardErrorUrl": "", + "OutputS3Region": "us-east-1", + "OutputS3BucketName": "", + "OutputS3KeyPrefix": "" + } + ], + "ServiceRole": "", + "NotificationConfig": { + "NotificationArn": "", + "NotificationEvents": [], + "NotificationType": "" + }, + "CloudWatchOutputConfig": { + "CloudWatchLogGroupName": "", + "CloudWatchOutputEnabled": false + } + }, + { + "CommandId": "ef7fdfd8-9b57-4151-a15c-db9a12345678", + "InstanceId": "i-12345abcdef678901", + "InstanceName": "", + "Comment": "", + "DocumentName": "AWS-RunPowerShellScript", + "DocumentVersion": "1", + "RequestedDateTime": 1550172741.906, + "Status": "Success", + "StatusDetails": "Success", + "StandardOutputUrl": "", + "StandardErrorUrl": "", + "CommandPlugins": [ + { + "Name": "aws:runPowerShellScript", + "Status": "Success", + "StatusDetails": "Success", + "ResponseCode": 0, + "ResponseStartDateTime": 1550172742.291, + "ResponseFinishDateTime": 1550172742.694, + "Output": "HelloWorld\r\n", + "StandardOutputUrl": "", + "StandardErrorUrl": "", + "OutputS3Region": "us-east-1", + "OutputS3BucketName": "", + "OutputS3KeyPrefix": "" + } + ], + "ServiceRole": "", + "NotificationConfig": { + "NotificationArn": "", + "NotificationEvents": [], + "NotificationType": "" + }, + "CloudWatchOutputConfig": { + "CloudWatchLogGroupName": "", + "CloudWatchOutputEnabled": false + } + } + ] } diff --git a/bin/awscli/examples/ssm/list-commands.rst b/bin/awscli/examples/ssm/list-commands.rst index 257e46a4..3a30195e 100755 --- a/bin/awscli/examples/ssm/list-commands.rst +++ b/bin/awscli/examples/ssm/list-commands.rst @@ -53,3 +53,11 @@ This example gets the status of a command. Command:: aws ssm list-commands --command-id "0831e1a8-a1ac-4257-a1fd-c831b48c4107" + +**To get the status of commands requested after a specific date** + +This example returns the details of commands requested after the specified date. + +Command:: + + aws ssm list-commands --filter "key=InvokedAfter,value=2019-02-01T00:00:00Z" \ No newline at end of file diff --git a/bin/awscli/examples/ssm/list-compliance-items.rst b/bin/awscli/examples/ssm/list-compliance-items.rst new file mode 100644 index 00000000..2382b786 --- /dev/null +++ b/bin/awscli/examples/ssm/list-compliance-items.rst @@ -0,0 +1,66 @@ +**To list compliance items for a specific instance** + +This example lists all compliance items for the specified instance. + +Command:: + + aws ssm list-compliance-items --resource-ids "i-1234567890abcdef0" --resource-types "ManagedInstance" + +Output:: + + { + "ComplianceItems": [ + { + "ComplianceType": "Association", + "ResourceType": "ManagedInstance", + "ResourceId": "i-1234567890abcdef0", + "Id": "8dfe3659-4309-493a-8755-0123456789ab", + "Title": "", + "Status": "COMPLIANT", + "Severity": "UNSPECIFIED", + "ExecutionSummary": { + "ExecutionTime": 1550408470.0 + }, + "Details": { + "DocumentName": "AWS-GatherSoftwareInventory", + "DocumentVersion": "1" + } + }, + { + "ComplianceType": "Association", + "ResourceType": "ManagedInstance", + "ResourceId": "i-1234567890abcdef0", + "Id": "e4c2ed6d-516f-41aa-aa2a-0123456789ab", + "Title": "", + "Status": "COMPLIANT", + "Severity": "UNSPECIFIED", + "ExecutionSummary": { + "ExecutionTime": 1550508475.0 + }, + "Details": { + "DocumentName": "AWS-UpdateSSMAgent", + "DocumentVersion": "1" + } + }, + ... + ], + "NextToken": "--token string truncated--" + } + +**To list compliance items for a specific instance and association ID** + +This example lists all compliance items for the specified instance and association ID. + +Command:: + + aws ssm list-compliance-items --resource-ids "i-1234567890abcdef0" --resource-types "ManagedInstance" --filters "Key=ComplianceType,Values=Association,Type=EQUAL" "Key=Id,Values=e4c2ed6d-516f-41aa-aa2a-0123456789ab,Type=EQUAL" + + +**To list compliance items for a instance after a specific date and time** + +This example lists all compliance items for an instance after the specified date and time. + +Command:: + + aws ssm list-compliance-items --resource-ids "i-1234567890abcdef0" --resource-types "ManagedInstance" --filters "Key=ExecutionTime,Values=2019-02-18T16:00:00Z,Type=GREATER_THAN" + diff --git a/bin/awscli/examples/ssm/list-compliance-summaries.rst b/bin/awscli/examples/ssm/list-compliance-summaries.rst new file mode 100644 index 00000000..0bf32379 --- /dev/null +++ b/bin/awscli/examples/ssm/list-compliance-summaries.rst @@ -0,0 +1,75 @@ +**To list compliance summaries for all compliance types** + +This example lists compliance summaries for all compliance types in your account. + +Command:: + + aws ssm list-compliance-summaries + +Output:: + + { + "ComplianceSummaryItems": [ + { + "ComplianceType": "Association", + "CompliantSummary": { + "CompliantCount": 2, + "SeveritySummary": { + "CriticalCount": 0, + "HighCount": 0, + "MediumCount": 0, + "LowCount": 0, + "InformationalCount": 0, + "UnspecifiedCount": 2 + } + }, + "NonCompliantSummary": { + "NonCompliantCount": 0, + "SeveritySummary": { + "CriticalCount": 0, + "HighCount": 0, + "MediumCount": 0, + "LowCount": 0, + "InformationalCount": 0, + "UnspecifiedCount": 0 + } + } + }, + { + "ComplianceType": "Patch", + "CompliantSummary": { + "CompliantCount": 1, + "SeveritySummary": { + "CriticalCount": 0, + "HighCount": 0, + "MediumCount": 0, + "LowCount": 0, + "InformationalCount": 0, + "UnspecifiedCount": 1 + } + }, + "NonCompliantSummary": { + "NonCompliantCount": 1, + "SeveritySummary": { + "CriticalCount": 1, + "HighCount": 0, + "MediumCount": 0, + "LowCount": 0, + "InformationalCount": 0, + "UnspecifiedCount": 0 + } + } + }, + ... + ], + "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ==" + } + +**To list compliance summaries for a specific compliance type** + +This example lists the compliance summary for the Patch compliance type. + +Command:: + + aws ssm list-compliance-summaries --filters "Key=ComplianceType,Values=Patch,Type=EQUAL" + diff --git a/bin/awscli/examples/ssm/list-documents.rst b/bin/awscli/examples/ssm/list-documents.rst index 243b9ac0..604a6ac1 100644 --- a/bin/awscli/examples/ssm/list-documents.rst +++ b/bin/awscli/examples/ssm/list-documents.rst @@ -34,3 +34,40 @@ Output:: ... ] } + +**To list all Command configuration documents in your account that you own** + +This example lists all Command documents in your account that you own. + +Command:: + + aws ssm list-documents --document-filter-list key=Owner,value=Self key=DocumentType,value=Command + +Output:: + + { + "DocumentIdentifiers": [ + { + "Name": "RunPowerShellScript", + "PlatformTypes": [ + "Windows", + "Linux" + ], + "DocumentVersion": "1", + "DocumentType": "Command", + "Owner": "111222333444", + "SchemaVersion": "2.0" + }, + { + "Name": "RunShellScript", + "PlatformTypes": [ + "Linux" + ], + "DocumentVersion": "1", + "DocumentType": "Command", + "Owner": "111222333444", + "SchemaVersion": "1.2" + }, + ... + ] + } \ No newline at end of file diff --git a/bin/awscli/examples/ssm/list-inventory-entries.rst b/bin/awscli/examples/ssm/list-inventory-entries.rst index 88212031..d278d606 100755 --- a/bin/awscli/examples/ssm/list-inventory-entries.rst +++ b/bin/awscli/examples/ssm/list-inventory-entries.rst @@ -1,21 +1,33 @@ -**To view custom inventory entries for an instance** +**To view specific inventory type entries for an instance** -This example lists all the custom inventory entries for an instance. +This example lists the inventory entries for the AWS:Application inventory type on a specific instance. Command:: - aws ssm list-inventory-entries --instance-id "i-0cb2b964d3e14fd9f" --type-name "Custom:RackInfo" + aws ssm list-inventory-entries --instance-id "i-1234567890abcdef0" --type-name "AWS:Application" Output:: { - "InstanceId": "i-0cb2b964d3e14fd9f", - "TypeName": "Custom:RackInfo", - "Entries": [ - { - "RackLocation": "Bay B/Row C/Rack D/Shelf E" - } - ], - "SchemaVersion": "1.0", - "CaptureTime": "2016-08-22T10:01:01Z" + "TypeName": "AWS:Application", + "InstanceId": "i-1234567890abcdef0", + "SchemaVersion": "1.1", + "CaptureTime": "2019-02-15T12:17:55Z", + "Entries": [ + { + "Architecture": "i386", + "Name": "Amazon SSM Agent", + "PackageId": "{88a60be2-89a1-4df8-812a-80863c2a2b68}", + "Publisher": "Amazon Web Services", + "Version": "2.3.274.0" + }, + { + "Architecture": "x86_64", + "InstalledTime": "2018-05-03T13:42:34Z", + "Name": "AmazonCloudWatchAgent", + "Publisher": "", + "Version": "1.200442.0" + }, + ... + ] } diff --git a/bin/awscli/examples/ssm/list-resource-compliance-summaries.rst b/bin/awscli/examples/ssm/list-resource-compliance-summaries.rst new file mode 100644 index 00000000..b54063b2 --- /dev/null +++ b/bin/awscli/examples/ssm/list-resource-compliance-summaries.rst @@ -0,0 +1,90 @@ +**To list resource-level compliance summary counts** + +This example lists resource-level compliance summary counts. + +Command:: + + aws ssm list-resource-compliance-summaries + +Output:: + + { + "ResourceComplianceSummaryItems": [ + { + "ComplianceType": "Association", + "ResourceType": "ManagedInstance", + "ResourceId": "i-1234567890abcdef0", + "Status": "COMPLIANT", + "OverallSeverity": "UNSPECIFIED", + "ExecutionSummary": { + "ExecutionTime": 1550509273.0 + }, + "CompliantSummary": { + "CompliantCount": 2, + "SeveritySummary": { + "CriticalCount": 0, + "HighCount": 0, + "MediumCount": 0, + "LowCount": 0, + "InformationalCount": 0, + "UnspecifiedCount": 2 + } + }, + "NonCompliantSummary": { + "NonCompliantCount": 0, + "SeveritySummary": { + "CriticalCount": 0, + "HighCount": 0, + "MediumCount": 0, + "LowCount": 0, + "InformationalCount": 0, + "UnspecifiedCount": 0 + } + } + }, + { + "ComplianceType": "Patch", + "ResourceType": "ManagedInstance", + "ResourceId": "i-9876543210abcdef0", + "Status": "COMPLIANT", + "OverallSeverity": "UNSPECIFIED", + "ExecutionSummary": { + "ExecutionTime": 1550248550.0, + "ExecutionId": "7abb6378-a4a5-4f10-8312-0123456789ab", + "ExecutionType": "Command" + }, + "CompliantSummary": { + "CompliantCount": 397, + "SeveritySummary": { + "CriticalCount": 0, + "HighCount": 0, + "MediumCount": 0, + "LowCount": 0, + "InformationalCount": 0, + "UnspecifiedCount": 397 + } + }, + "NonCompliantSummary": { + "NonCompliantCount": 0, + "SeveritySummary": { + "CriticalCount": 0, + "HighCount": 0, + "MediumCount": 0, + "LowCount": 0, + "InformationalCount": 0, + "UnspecifiedCount": 0 + } + } + } + ], + "NextToken": "--token string truncated--" + } + +**To list resource-level compliance summaries for a specific compliance type** + +This example lists resource-level compliance summaries for the Patch compliance type. + +Command:: + + aws ssm list-resource-compliance-summaries --filters "Key=ComplianceType,Values=Patch,Type=EQUAL" + diff --git a/bin/awscli/examples/ssm/list-resource-data-sync.rst b/bin/awscli/examples/ssm/list-resource-data-sync.rst new file mode 100644 index 00000000..2b871df6 --- /dev/null +++ b/bin/awscli/examples/ssm/list-resource-data-sync.rst @@ -0,0 +1,27 @@ +**To list your resource data sync configurations** + +This example retrieves information about your resource data sync configurations. + +Command:: + + aws ssm list-resource-data-sync --sync-name "ssm-resource-data-sync" + +Output:: + + { + "ResourceDataSyncItems": [ + { + "SyncName": "ssm-resource-data-sync", + "S3Destination": { + "BucketName": "ssm-resource-data-sync", + "SyncFormat": "JsonSerDe", + "Region": "us-east-1" + }, + "LastSyncTime": 1550261472.003, + "LastSuccessfulSyncTime": 1550261472.003, + "LastStatus": "Successful", + "SyncCreatedTime": 1543235736.72, + "LastSyncStatusMessage": "The sync was successfully completed" + } + ] + } diff --git a/bin/awscli/examples/ssm/list-tags-for-resource.rst b/bin/awscli/examples/ssm/list-tags-for-resource.rst index 0210f797..1d19aae7 100755 --- a/bin/awscli/examples/ssm/list-tags-for-resource.rst +++ b/bin/awscli/examples/ssm/list-tags-for-resource.rst @@ -4,15 +4,15 @@ This example lists the tags for a patch baseline. Command:: - aws ssm list-tags-for-resource --resource-type "PatchBaseline" --resource-id "pb-0869b5cf84fa07081" + aws ssm list-tags-for-resource --resource-type "PatchBaseline" --resource-id "pb-0123456789abcdef0" Output:: { - "TagList": [ - { - "Value": "Project", - "Key": "Testing" - } - ] + "TagList": [ + { + "Key": "Project", + "Value": "Testing" + } + ] } diff --git a/bin/awscli/examples/ssm/put-compliance-items.rst b/bin/awscli/examples/ssm/put-compliance-items.rst new file mode 100644 index 00000000..cb693541 --- /dev/null +++ b/bin/awscli/examples/ssm/put-compliance-items.rst @@ -0,0 +1,8 @@ +**To register a compliance type and compliance details to a designated instance** + +This example registers the compliance type ``Custom:AVCheck`` to the specified managed instance. There is no output if the command succeeds. + +Command:: + + aws ssm put-compliance-items --resource-id "i-1234567890abcdef0" --resource-type "ManagedInstance" --compliance-type "Custom:AVCheck" --execution-summary "ExecutionTime=2019-02-18T16:00:00Z" --items "Id=Version2.0,Title=ScanHost,Severity=CRITICAL,Status=COMPLIANT" + diff --git a/bin/awscli/examples/ssm/put-inventory.rst b/bin/awscli/examples/ssm/put-inventory.rst index 9a13cb6a..a065ae42 100755 --- a/bin/awscli/examples/ssm/put-inventory.rst +++ b/bin/awscli/examples/ssm/put-inventory.rst @@ -2,7 +2,10 @@ This example assigns rack location information to an instance. There is no output if the command succeeds. -Command:: +Command (Linux):: - aws ssm put-inventory --instance-id "i-0cb2b964d3e14fd9f" --items '[{"CaptureTime": "2016-08-22T10:01:01Z", "TypeName": "Custom:RackInfo", "Content":[{"RackLocation": "Bay B/Row C/Rack D/Shelf E"}], "SchemaVersion": "1.0"}]' - \ No newline at end of file + aws ssm put-inventory --instance-id "i-016648b75dd622dab" --items '[{"TypeName": "Custom:RackInfo","SchemaVersion": "1.0","CaptureTime": "2019-01-22T10:01:01Z","Content":[{"RackLocation": "Bay B/Row C/Rack D/Shelf E"}]}]' + +Command (Windows):: + + aws ssm put-inventory --instance-id "i-016648b75dd622dab" --items "TypeName=Custom:RackInfo,SchemaVersion=1.0,CaptureTime=2019-01-22T10:01:01Z,Content=[{RackLocation='Bay B/Row C/Rack D/Shelf F'}]" \ No newline at end of file diff --git a/bin/awscli/examples/ssm/put-parameter.rst b/bin/awscli/examples/ssm/put-parameter.rst index 528064ec..5e0fc8f1 100755 --- a/bin/awscli/examples/ssm/put-parameter.rst +++ b/bin/awscli/examples/ssm/put-parameter.rst @@ -1,24 +1,93 @@ -**To create a parameter that uses a String data type** +**Example 1: To change a parameter value** -This example creates a parameter. There is no output if the command succeeds. +The following ``put-parameter`` example changes the value of a parameter. :: -Command:: + aws ssm put-parameter \ + --name "welcome" \ + --type "String" \ + --value "good day sunshine" \ + --overwrite - aws ssm put-parameter --name "welcome" --type "String" --value "helloWorld" +Output:: -**To create a Secure String parameter** + { + "Version": 2 + } -This example creates a Secure String parameter. Singles quotes are used so that the literal value is passed. There is no output if the command succeeds. +For more information, see `About Parameters `__ in the *AWS Systems Manager User Guide*. -Command:: +**Example 2: To create an advanced parameter** - aws ssm put-parameter --name 'password' --type "SecureString" --value 'a value, for example P@ssW%rd#1' +The following ``put-parameter`` example creates an advanced parameter. :: -**To change a parameter value** + aws ssm put-parameter \ + --name "advanced-parameter" \ + --value "This is an advanced parameter" \ + --type "String" \ + --tier Advanced -This example changes the value of a parameter. There is no output if the command succeeds. +Output:: -Command:: + { + "Version": 1 + } - aws ssm put-parameter --name "welcome" --type "String" --value "good day sunshine" --overwrite - +For more information, see `About Advanced Parameters `__ in the *AWS Systems Manager User Guide*. + +**Example 3: To convert a standard parameter to an advanced parameter** + +The following ``put-parameter`` example converts a existing standard parameter into an advanced parameter. :: + + aws ssm put-parameter \ + --name "convert" \ + --value "Test" \ + --type "String" \ + --tier Advanced \ + --overwrite + +Output:: + + { + "Version": 2 + } + +For more information, see `About Advanced Parameters `__ in the *AWS Systems Manager User Guide*. + +**Example 4: To create a parameter with a policy attached** + +The following ``put-parameter`` example creates an advanced parameter with a parameter policy attached. :: + + aws ssm put-parameter \ + --name "/Finance/Payroll/elixir3131" \ + --value "P@sSwW)rd" \ + --type "SecureString" \ + --tier Advanced \ + --policies "[{\"Type\":\"Expiration\",\"Version\":\"1.0\",\"Attributes\":{\"Timestamp\":\"2019-05-13T00:00:00.000Z\"}},{\"Type\":\"ExpirationNotification\",\"Version\":\"1.0\",\"Attributes\":{\"Before\":\"5\",\"Unit\":\"Days\"}},{\"Type\":\"NoChangeNotification\",\"Version\":\"1.0\",\"Attributes\":{\"After\":\"60\",\"Unit\":\"Days\"}}]" + +Output:: + + { + "Version": 1 + } + +For more information, see `Working with Parameter Policies `__ in the *AWS Systems Manager User Guide*. + +**Example 5: To add a policy to an existing parameter** + +The following ``put-parameter`` example attaches a policy to an existing advanced parameter. :: + + aws ssm put-parameter \ + --name "/Finance/Payroll/elixir3131" \ + --value "N3wP@sSwW)rd" \ + --type "SecureString" \ + --tier Advanced \ + --policies "[{\"Type\":\"Expiration\",\"Version\":\"1.0\",\"Attributes\":{\"Timestamp\":\"2019-05-13T00:00:00.000Z\"}},{\"Type\":\"ExpirationNotification\",\"Version\":\"1.0\",\"Attributes\":{\"Before\":\"5\",\"Unit\":\"Days\"}},{\"Type\":\"NoChangeNotification\",\"Version\":\"1.0\",\"Attributes\":{\"After\":\"60\",\"Unit\":\"Days\"}}]" + --overwrite + +Output:: + + { + "Version": 2 + } + +For more information, see `Working with Parameter Policies `__ in the *AWS Systems Manager User Guide*. diff --git a/bin/awscli/examples/ssm/register-patch-baseline-for-patch-group.rst b/bin/awscli/examples/ssm/register-patch-baseline-for-patch-group.rst index 30b9f5cc..b13218e9 100755 --- a/bin/awscli/examples/ssm/register-patch-baseline-for-patch-group.rst +++ b/bin/awscli/examples/ssm/register-patch-baseline-for-patch-group.rst @@ -9,6 +9,6 @@ Command:: Output:: { - "PatchGroup": "Production", - "BaselineId": "pb-045f10b4f382baeda" + "BaselineId": "pb-045f10b4f382baeda", + "PatchGroup": "Production" } diff --git a/bin/awscli/examples/ssm/register-target-with-maintenance-window.rst b/bin/awscli/examples/ssm/register-target-with-maintenance-window.rst index 2f7c92c0..b46dfecd 100755 --- a/bin/awscli/examples/ssm/register-target-with-maintenance-window.rst +++ b/bin/awscli/examples/ssm/register-target-with-maintenance-window.rst @@ -1,6 +1,6 @@ -**To register a single target with a maintenance window** +**To register a single target with a Maintenance Window** -This example registers an instance with a maintenance window. +This example registers an instance with a Maintenance Window. Command:: @@ -12,17 +12,17 @@ Output:: "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" } -**To register multiple targets with a maintenance window** +**To register multiple targets with a Maintenance Window** -This example registers two instances with a maintenance window. +This example registers two instances with a Maintenance Window. Command:: aws ssm register-target-with-maintenance-window --window-id "mw-ab12cd34ef56gh78" --target "Key=InstanceIds,Values=i-0000293ffd8c57862,i-0cb2b964d3e14fd9f" --owner-information "Two instances in a list" --resource-type "INSTANCE" -**To register a target with a maintenance window using EC2 tags** +**To register a target with a Maintenance Window using EC2 tags** -This example registers an instance with a maintenance window using EC2 tags. +This example registers an instance with a Maintenance Window using EC2 tags. Command:: diff --git a/bin/awscli/examples/ssm/register-task-with-maintenance-window.rst b/bin/awscli/examples/ssm/register-task-with-maintenance-window.rst index 1d62f365..0a1fbbea 100755 --- a/bin/awscli/examples/ssm/register-task-with-maintenance-window.rst +++ b/bin/awscli/examples/ssm/register-task-with-maintenance-window.rst @@ -56,7 +56,7 @@ Output:: **To register a task using a Maintenance Windows target ID** -This example registers a task using a Maintenance Window target ID. The maintenance window target ID was in the output of the ``aws ssm register-target-with-maintenance-window`` command, otherwise you can retrieve it from the output of the ``aws ssm describe-maintenance-window-targets`` command. +This example registers a task using a Maintenance Window target ID. The Maintenance Window target ID was in the output of the ``aws ssm register-target-with-maintenance-window`` command, otherwise you can retrieve it from the output of the ``aws ssm describe-maintenance-window-targets`` command. Command:: diff --git a/bin/awscli/examples/ssm/remove-tags-from-resource.rst b/bin/awscli/examples/ssm/remove-tags-from-resource.rst index 78fc0532..338aa485 100755 --- a/bin/awscli/examples/ssm/remove-tags-from-resource.rst +++ b/bin/awscli/examples/ssm/remove-tags-from-resource.rst @@ -4,4 +4,4 @@ This example removes the tags from a patch baseline. There is no output if the c Command:: - aws ssm remove-tags-from-resource --resource-type "PatchBaseline" --resource-id "pb-0869b5cf84fa07081" --tag-keys "Project" + aws ssm remove-tags-from-resource --resource-type "PatchBaseline" --resource-id "pb-0123456789abcdef0" --tag-keys "Project" diff --git a/bin/awscli/examples/ssm/reset-service-setting.rst b/bin/awscli/examples/ssm/reset-service-setting.rst new file mode 100644 index 00000000..3747e2ea --- /dev/null +++ b/bin/awscli/examples/ssm/reset-service-setting.rst @@ -0,0 +1,22 @@ +**To reset the service setting for Parameter Store throughput** + +The following ``reset-service-setting`` example resets the service setting for Parameter Store throughput in the specified region to no longer use increased throughput. :: + + aws ssm reset-service-setting \ + --setting-id arn:aws:ssm:us-east-1:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled + +Output:: + + { + "ServiceSetting": { + "SettingId": "/ssm/parameter-store/high-throughput-enabled", + "SettingValue": "false", + "LastModifiedDate": 1555532818.578, + "LastModifiedUser": "System", + "ARN": "arn:aws:ssm:us-east-1:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled", + "Status": "Default" + } + } + +For more information, see `Increasing Parameter Store Throughput `_ in the *AWS Systems Manager User Guide*. + diff --git a/bin/awscli/examples/ssm/resume-session.rst b/bin/awscli/examples/ssm/resume-session.rst new file mode 100644 index 00000000..7faa0042 --- /dev/null +++ b/bin/awscli/examples/ssm/resume-session.rst @@ -0,0 +1,20 @@ +**To resume a Session Manager session** + +This example resumes a Session Manager session with an instance after it has been disconnected. + +Note that this interactive command requires the Session Manager plugin to be installed on the client machine making the call. For more information, see `Install the Session Manager Plugin for the AWS CLI`_ in the *AWS Systems Manager User Guide*. + +.. _`Install the Session Manager Plugin for the AWS CLI`: http://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html + +Command:: + + aws ssm resume-session -session-id Dan-07a16060613c408b5 + +Output:: + + { + "SessionId": "Dan-07a16060613c408b5", + "TokenValue": "AAEAAVbTGsaOnyvcUoNGqifbv5r/8lgxuQljCuY8qVcvOnoBAAAAAFxtd3jIXAFUUXGTJ7zF/AWJPwDviOlF5p3dlAgrqVIVO6IEXhkHLz0/1gXKRKEME71E6TLOplLDJAMZ+kREejkZu4c5AxMkrQjMF+gtHP1bYJKTwtHQd1wjulPLexO8SHl7g5R/wekrj6WsDUpnEegFBfGftpAIz2GXQVfTJXKfkc5qepQ11C11DOIT2dozOqXgHwfQHfAKLErM5dWDZqKwyT1Z3iw7unQdm3p5qsbrugiOZ7CRANTE+ihfGa6MEJJ97Jmat/a2TspEnOjNn9Mvu5iwXIW2yCvWZrGUj+/QI5Xr7s1XJBEnSKR54o4fN0GV9RWl0RZsZm1m1ki0JJtiwwgZ", + "StreamUrl": "wss://ssmmessages.us-east-1.amazonaws.com/v1/data-channel/Dan-07a16060613c408b5?role=publish_subscribe" + } + diff --git a/bin/awscli/examples/ssm/send-automation-signal.rst b/bin/awscli/examples/ssm/send-automation-signal.rst new file mode 100644 index 00000000..35199c57 --- /dev/null +++ b/bin/awscli/examples/ssm/send-automation-signal.rst @@ -0,0 +1,40 @@ +**To send a signal to an Automation execution** + +This example sends the Approve signal to an Automation execution. There is no output if the command succeeds. + +Command:: + + aws ssm send-automation-signal --automation-execution-id 4105a4fc-f944-11e6-9d32-0a1b2c3d495h --signal-type "Approve" + +**To send an approve signal with a comment to an Automation execution** + +This example sends the Approve signal with a comment to an Automation execution. There is no output if the command succeeds. + +Command:: + + aws ssm send-automation-signal --automation-execution-id 4105a4fc-f944-11e6-9d32-0a1b2c3d495h --signal-type "Approve" --payload "Comment=Approved" + +**To start an Automation step** + +This example starts the specified step in an Automation execution. There is no output if the command succeeds. + +Command:: + + aws ssm send-automation-signal --automation-execution-id 4105a4fc-f944-11e6-9d32-0a1b2c3d495h --signal-type "StartStep" --payload "StepName=stopInstances" + +**To resume an Automation step** + +This example resumes the specified step in an Automation execution. There is no output if the command succeeds. + +Command:: + + aws ssm send-automation-signal --automation-execution-id 4105a4fc-f944-11e6-9d32-0a1b2c3d495h --signal-type "Resume" --payload "StepName=stopInstances" + +**To stop an Automation step** + +This example stops the specified step that is currently in progress within an Automation execution. There is no output if the command succeeds. + +Command:: + + aws ssm send-automation-signal --automation-execution-id 4105a4fc-f944-11e6-9d32-0a1b2c3d495h --signal-type "StopStep" --payload "StepExecutionId=35de5ba9-e3de-45ae-8c95-0123456789ab" + diff --git a/bin/awscli/examples/ssm/send-command.rst b/bin/awscli/examples/ssm/send-command.rst index 6048d969..2a1a6c41 100755 --- a/bin/awscli/examples/ssm/send-command.rst +++ b/bin/awscli/examples/ssm/send-command.rst @@ -1,56 +1,113 @@ -**To execute a command on one or more remote instances** +**Example 1: To run a command on one or more remote instances** -This example runs an echo command on a target instance. +The following ``send-command`` example runs an ``echo`` command on a target instance. :: -Command:: - - aws ssm send-command --document-name "AWS-RunPowerShellScript" --parameters commands=["echo helloWorld"] --targets "Key=instanceids,Values=i-0cb2b964d3e14fd9f" + aws ssm send-command \ + --document-name "AWS-RunShellScript" \ + --parameters commands=["echo HelloWorld"] \ + --targets "Key=instanceids,Values=i-1234567890abcdef0" \ + --comment "echo HelloWorld" Output:: - { - "Command": { - "Comment": "", - "Status": "Pending", - "MaxErrors": "0", - "Parameters": { - "commands": [ - "echo helloWorld" - ] - }, - "ExpiresAfter": 1487888845.833, - "ServiceRole": "", - "DocumentName": "AWS-RunPowerShellScript", - "TargetCount": 0, - "OutputS3BucketName": "", - "NotificationConfig": { - "NotificationArn": "", - "NotificationEvents": [], - "NotificationType": "" - }, - "CompletedCount": 0, - "Targets": [ - { - "Values": [ - "i-0cb2b964d3e14fd9f" - ], - "Key": "instanceids" + { + "Command": { + "CommandId": "92853adf-ba41-4cd6-9a88-142d119c083d", + "DocumentName": "AWS-RunShellScript", + "DocumentVersion": "", + "Comment": "echo HelloWorld", + "ExpiresAfter": 1550181014.717, + "Parameters": { + "commands": [ + "echo HelloWorld" + ] + }, + "InstanceIds": [ + "i-0f00f008a2dcbefe2" + ], + "Targets": [], + "RequestedDateTime": 1550173814.717, + "Status": "Pending", + "StatusDetails": "Pending", + "OutputS3BucketName": "", + "OutputS3KeyPrefix": "", + "MaxConcurrency": "50", + "MaxErrors": "0", + "TargetCount": 1, + "CompletedCount": 0, + "ErrorCount": 0, + "DeliveryTimedOutCount": 0, + "ServiceRole": "", + "NotificationConfig": { + "NotificationArn": "", + "NotificationEvents": [], + "NotificationType": "" + }, + "CloudWatchOutputConfig": { + "CloudWatchLogGroupName": "", + "CloudWatchOutputEnabled": false } - ], - "StatusDetails": "Pending", - "ErrorCount": 0, - "OutputS3KeyPrefix": "", - "RequestedDateTime": 1487885245.833, - "CommandId": "0d4fc863-2154-4e46-990e-d6a952469e91", - "InstanceIds": [], - "MaxConcurrency": "50" + } } - } -**To get IP information about an instance** +**Example 2: To get IP information about an instance** + +The following ``send-command`` example retrieves the IP information about an instance. :: + + aws ssm send-command \ + --instance-ids "i-1234567890abcdef0" \ + --document-name "AWS-RunShellScript" \ + --comment "IP config" \ + --parameters "commands=ifconfig" + +**Example 3: To runs a command on instances with specific tags** + +The following ``send-command`` example runs a command on instances that have the tag key "ENV" and the value "Dev". :: + + aws ssm send-command \ + --targets "Key=tag:ENV,Values=Dev" \ + --document-name "AWS-RunShellScript" \ + --parameters "commands=ifconfig" + +**Example 4: To runs a command that sends SNS Notifications** + +The following ``send-command`` example runs a command that sends SNS notifications for all notification events and the Command notification type. :: + + aws ssm send-command \ + --instance-ids "i-1234567890abcdef0" \ + --document-name "AWS-RunShellScript" \ + --comment "IP config" \ + --parameters "commands=ifconfig" \ + --service-role-arn "arn:aws:iam::123456789012:role/SNS_Role" \ + --notification-config "NotificationArn=arn:aws:sns:us-east-1:123456789012:SNSTopicName,NotificationEvents=All,NotificationType=Command" + +**Example 5: To run a command that outputs to S3 and CloudWatch** + +The following ``send-command`` example runs a command that outputs command details to an S3 bucket and to a CloudWatch Logs Group. :: + + aws ssm send-command \ + --instance-ids "i-1234567890abcdef0" \ + --document-name "AWS-RunShellScript" \ + --comment "IP config" \ + --parameters "commands=ifconfig" \ + --output-s3-bucket-name "s3-bucket-name" \ + --output-s3-key-prefix "runcommand" \ + --cloud-watch-output-config "CloudWatchOutputEnabled=true,CloudWatchLogGroupName=CWLGroupName" + +**Example 6: To run commands on multiple instances with different tags** + +The follwoing ``send-command`` example runs a command on instances with two different tag keys and values. :: + + aws ssm send-command \ + --document-name "AWS-RunPowerShellScript" \ + --parameters commands=["echo helloWorld"] \ + --targets Key=tag:Env,Values=Dev Key=tag:Role,Values=WebServers -This example gets the IP information about an instance. +**Example 7: To target multiple instances with the same tag key** -Command:: +The following ``send-command`` example runs a command on instances that have the same tag key but with different values. :: - aws ssm send-command --instance-ids "i-0cb2b964d3e14fd9f" --document-name "AWS-RunShellScript" --comment "IP config" --parameters "commands=ifconfig" --output text + aws ssm send-command \ + --document-name "AWS-RunPowerShellScript" \ + --parameters commands=["echo helloWorld"] \ + --targets Key=tag:Env,Values=Dev,Test diff --git a/bin/awscli/examples/ssm/start-associations-once.rst b/bin/awscli/examples/ssm/start-associations-once.rst new file mode 100644 index 00000000..7b82d0de --- /dev/null +++ b/bin/awscli/examples/ssm/start-associations-once.rst @@ -0,0 +1,8 @@ +**To execute an association immediately and only one time** + +This example executes the specified association immediately and only once. There is no output if the command succeeds. + +Command:: + + aws ssm start-associations-once --association-id "8dfe3659-4309-493a-8755-0123456789ab" + diff --git a/bin/awscli/examples/ssm/start-automation-execution.rst b/bin/awscli/examples/ssm/start-automation-execution.rst index cbc28237..70b853c3 100755 --- a/bin/awscli/examples/ssm/start-automation-execution.rst +++ b/bin/awscli/examples/ssm/start-automation-execution.rst @@ -4,10 +4,24 @@ This example executes a document. Command:: - aws ssm start-automation-execution --document-name "AWS-UpdateLinuxAmi" --parameters "AutomationAssumeRole=arn:aws:iam::812345678901:role/SSMAutomationRole,SourceAmiId=ami-f173cc91,IamInstanceProfileName=EC2InstanceRole" + aws ssm start-automation-execution --document-name "AWS-UpdateLinuxAmi" --parameters "AutomationAssumeRole=arn:aws:iam::123456789012:role/SSMAutomationRole,SourceAmiId=ami-f1730123,IamInstanceProfileName=EC2InstanceRole" Output:: { - "AutomationExecutionId": "4105a4fc-f944-11e6-9d32-8fb2db27a909" + "AutomationExecutionId": "4105a4fc-f944-11e6-9d32-0a1b2c3d495h" + } + +**To initiate the execution of an Automation document in multiple accounts** + +This example restarts Amazon EC2 instances in the 1a2b3c4d5e6f7g8h and a1b2c3d4e5f6h7 accounts, which are located in the us-east-2 and us-west-1 Regions. The instances must be tagged with Env-PROD. + +Command:: + + aws ssm start-automation-execution --document-name AWS-RestartEC2Instance --parameters AutomationAssumeRole=arn:aws:iam::123456789012:role/AWS-SystemsManager-AutomationAdministrationRole --target-parameter-name InstanceId --targets Key=tag:Env,Values=PROD --target-locations Accounts=1a2b3c4d5e6f7g8h,a1b2c3d4e5f6h7,Regions=us-east-2,us-west-1,ExecutionRoleName=AWS-SystemsManager-AutomationExecutionRole + +Output:: + + { + "AutomationExecutionId": "4105a4fc-f944-11e6-9d32-0a1b2c3d495h" } diff --git a/bin/awscli/examples/ssm/start-session.rst b/bin/awscli/examples/ssm/start-session.rst new file mode 100644 index 00000000..a60fc889 --- /dev/null +++ b/bin/awscli/examples/ssm/start-session.rst @@ -0,0 +1,16 @@ +**To start a Session Manager session** + +This example establishes a connection with an instance for a Session Manager session. + +Note that this interactive command requires the Session Manager plugin to be installed on the client machine making the call. For more information, see `Install the Session Manager Plugin for the AWS CLI`_ in the *AWS Systems Manager User Guide*. + +.. _`Install the Session Manager Plugin for the AWS CLI`: http://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html + +Command:: + + aws ssm start-session --target "i-1234567890abcdef0" + +Output:: + + Starting session with SessionId: Erik-07a16060613c408b5 + diff --git a/bin/awscli/examples/ssm/stop-automation-execution.rst b/bin/awscli/examples/ssm/stop-automation-execution.rst index 3053154d..0b3ecf47 100755 --- a/bin/awscli/examples/ssm/stop-automation-execution.rst +++ b/bin/awscli/examples/ssm/stop-automation-execution.rst @@ -4,5 +4,12 @@ This example stops an automation execution. There is no output if the command su Command:: - aws ssm stop-automation-execution --automation-execution-id "4105a4fc-f944-11e6-9d32-8fb2db27a909" - \ No newline at end of file + aws ssm stop-automation-execution --automation-execution-id "4105a4fc-f944-11e6-9d32-0a1b2c3d495h" + +**To cancel the execution of an Automation document** + +This example cancels an automation execution. There is no output if the command succeeds. + +Command:: + + aws ssm stop-automation-execution --automation-execution-id "4105a4fc-f944-11e6-9d32-0a1b2c3d495h" --type "Cancel" diff --git a/bin/awscli/examples/ssm/terminate-session.rst b/bin/awscli/examples/ssm/terminate-session.rst new file mode 100644 index 00000000..842bca16 --- /dev/null +++ b/bin/awscli/examples/ssm/terminate-session.rst @@ -0,0 +1,13 @@ +**To end a Session Manager session** + +This example permanently ends a session that was created by the user "Bob" and closes the data connection between the Session Manager client and SSM Agent on the instance. + +Command:: + + aws ssm terminate-session --session-id "Bob-07a16060613c408b5" + +Output:: + + { + "SessionId": "Bob-07a16060613c408b5" + } diff --git a/bin/awscli/examples/ssm/update-association-status.rst b/bin/awscli/examples/ssm/update-association-status.rst index 225483a5..470f4616 100644 --- a/bin/awscli/examples/ssm/update-association-status.rst +++ b/bin/awscli/examples/ssm/update-association-status.rst @@ -4,38 +4,40 @@ This example updates the association status of the association between an instan Command:: - aws ssm update-association-status --name "AWS-UpdateSSMAgent" --instance-id "i-0000293ffd8c57862" --association-status "Date=1424421071.939,Name=Pending,Message=temp_status_change,AdditionalInfo=Additional-Config-Needed" + aws ssm update-association-status --name "AWS-UpdateSSMAgent" --instance-id "i-1234567890abcdef0" --association-status "Date=1424421071.939,Name=Pending,Message=temp_status_change,AdditionalInfo=Additional-Config-Needed" Output:: { "AssociationDescription": { + "Name": "AWS-UpdateSSMAgent", + "InstanceId": "i-1234567890abcdef0", + "AssociationVersion": "1", + "Date": 1550507529.604, + "LastUpdateAssociationDate": 1550507806.974, "Status": { "Date": 1424421071.0, - "AdditionalInfo": "Additional-Config-Needed", + "Name": "Pending", "Message": "temp_status_change", - "Name": "Pending" + "AdditionalInfo": "Additional-Config-Needed" }, - "Name": "AWS-UpdateSSMAgent", - "InstanceId": "i-0000293ffd8c57862", "Overview": { - "Status": "Pending", - "DetailedStatus": "Associated", + "Status": "Success", "AssociationStatusAggregatedCount": { - "Pending": 1 + "Success": 1 } }, - "AssociationId": "d8617c07-2079-4c18-9847-1655fc2698b0", "DocumentVersion": "$DEFAULT", - "LastUpdateAssociationDate": 1487876122.564, - "Date": 1487876122.564, + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", "Targets": [ { + "Key": "InstanceIds", "Values": [ - "i-0000293ffd8c57862" - ], - "Key": "InstanceIds" + "i-1234567890abcdef0" + ] } - ] + ], + "LastExecutionDate": 1550507808.0, + "LastSuccessfulExecutionDate": 1550507808.0 } } diff --git a/bin/awscli/examples/ssm/update-association.rst b/bin/awscli/examples/ssm/update-association.rst index 9cbd860c..3cfcf1d2 100755 --- a/bin/awscli/examples/ssm/update-association.rst +++ b/bin/awscli/examples/ssm/update-association.rst @@ -4,32 +4,40 @@ This example updates an association with a new document version. Command:: - aws ssm update-association --association-id "4cc73e42-d5ae-4879-84f8-57e09c0efcd0" --document-version "\$LATEST" + aws ssm update-association --association-id "8dfe3659-4309-493a-8755-0123456789ab" --document-version "\$LATEST" Output:: { "AssociationDescription": { - "LastSuccessfulExecutionDate": 1487906247.0, "Name": "AWS-UpdateSSMAgent", - "LastExecutionDate": 1487906247.0, + "AssociationVersion": "2", + "Date": 1550508093.293, + "LastUpdateAssociationDate": 1550508106.596, "Overview": { - "Status": "Success", - "AssociationStatusAggregatedCount": { - "Success": 1 - } + "Status": "Pending", + "DetailedStatus": "Creating" }, - "AssociationId": "4cc73e42-d5ae-4879-84f8-57e09c0efcd0", "DocumentVersion": "$LATEST", - "LastUpdateAssociationDate": 1487906288.447, - "Date": 1487906246.999, + "AssociationId": "8dfe3659-4309-493a-8755-0123456789ab", "Targets": [ { + "Key": "tag:Name", "Values": [ - "i-0cb2b964d3e14fd9f" - ], - "Key": "instanceids" + "Linux" + ] } - ] + ], + "LastExecutionDate": 1550508094.879, + "LastSuccessfulExecutionDate": 1550508094.879 } } + +**To update the schedule expression of an association** + +This example updates the schedule expression for the specified association. + +Command:: + + aws ssm update-association --association-id "8dfe3659-4309-493a-8755-0123456789ab" --schedule-expression "cron(0 0 0/4 1/1 * ? *)" + diff --git a/bin/awscli/examples/ssm/update-maintenance-window-target.rst b/bin/awscli/examples/ssm/update-maintenance-window-target.rst new file mode 100644 index 00000000..b4a4c1be --- /dev/null +++ b/bin/awscli/examples/ssm/update-maintenance-window-target.rst @@ -0,0 +1,26 @@ +**To update a Maintenance Window target** + +This example updates the name of a Maintenance Window target. + +Command:: + + aws ssm update-maintenance-window-target --window-id "mw-0c5ed765acEXAMPLE" --window-target-id "57e8344e-fe64-4023-8191-6bf05EXAMPLE" --name "NewName" + +Output:: + + { + "Description": "", + "OwnerInformation": "", + "WindowTargetId": "57e8344e-fe64-4023-8191-6bf05EXAMPLE", + "WindowId": "mw-0c5ed765acEXAMPLE", + "Targets": [ + { + "Values": [ + "i-1234567890EXAMPLE" + ], + "Key": "InstanceIds" + } + ], + "Name": "NewName" + } + \ No newline at end of file diff --git a/bin/awscli/examples/ssm/update-maintenance-window-task.rst b/bin/awscli/examples/ssm/update-maintenance-window-task.rst new file mode 100644 index 00000000..e108d1ee --- /dev/null +++ b/bin/awscli/examples/ssm/update-maintenance-window-task.rst @@ -0,0 +1,40 @@ +**To update a Maintenance Window task** + +This example updates the service role for a Maintenance Window task. + +Command:: + + aws ssm update-maintenance-window-task --window-id "mw-0c5ed765acEXAMPLE" --window-task-id "23d3809e-9fbe-4ddf-b41a-b49d7EXAMPLE" --service-role-arn "arn:aws:iam::111222333444:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM" + +Output:: + + { + "ServiceRoleArn": "arn:aws:iam::111222333444:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM", + "MaxErrors": "1", + "TaskArn": "AWS-UpdateEC2Config", + "MaxConcurrency": "1", + "WindowTaskId": "23d3809e-9fbe-4ddf-b41a-b49d7EXAMPLE", + "TaskParameters": {}, + "Priority": 1, + "TaskInvocationParameters": { + "RunCommand": { + "TimeoutSeconds": 600, + "Parameters": { + "allowDowngrade": [ + "false" + ] + } + } + }, + "WindowId": "mw-0c5ed765acEXAMPLE", + "Description": "UpdateEC2Config", + "Targets": [ + { + "Values": [ + "57e8344e-fe64-4023-8191-6bf05EXAMPLE" + ], + "Key": "WindowTargetIds" + } + ], + "Name": "UpdateEC2Config" + } diff --git a/bin/awscli/examples/ssm/update-maintenance-window.rst b/bin/awscli/examples/ssm/update-maintenance-window.rst index c904a676..e27bea2a 100755 --- a/bin/awscli/examples/ssm/update-maintenance-window.rst +++ b/bin/awscli/examples/ssm/update-maintenance-window.rst @@ -1,6 +1,6 @@ -**To update a maintenance window** +**To update a Maintenance Window** -This example updates the name of a maintenance window. +This example updates the name of a Maintenance Window. Command:: @@ -18,17 +18,17 @@ Output:: "Duration": 4 } -**To enable a maintenance window** +**To enable a Maintenance Window** -This example enables a maintenance window. +This example enables a Maintenance Window. Command:: aws ssm update-maintenance-window --window-id "mw-1a2b3c4d5e6f7g8h9" --enabled -**To disable a maintenance window** +**To disable a Maintenance Window** -This example disables a maintenance window. +This example disables a Maintenance Window. Command:: diff --git a/bin/awscli/examples/ssm/update-patch-baseline.rst b/bin/awscli/examples/ssm/update-patch-baseline.rst index 2f1673fc..b8377086 100755 --- a/bin/awscli/examples/ssm/update-patch-baseline.rst +++ b/bin/awscli/examples/ssm/update-patch-baseline.rst @@ -4,17 +4,14 @@ This example adds two patches as rejected and one patch as approved to a patch b Command:: - aws ssm update-patch-baseline --baseline-id "pb-045f10b4f382baeda" --rejected-patches "KB2032276" "MS10-048" --approved-patches "KB2124261" + aws ssm update-patch-baseline --baseline-id "pb-0123456789abcdef0" --rejected-patches "KB2032276" "MS10-048" --approved-patches "KB2124261" Output:: { - "BaselineId": "pb-045f10b4f382baeda", - "Name": "Production-Baseline", - "RejectedPatches": [ - "KB2032276", - "MS10-048" - ], + "BaselineId": "pb-0123456789abcdef0", + "Name": "WindowsPatching", + "OperatingSystem": "WINDOWS", "GlobalFilters": { "PatchFilters": [] }, @@ -24,34 +21,33 @@ Output:: "PatchFilterGroup": { "PatchFilters": [ { + "Key": "PRODUCT", "Values": [ - "Critical", - "Important", - "Moderate" - ], - "Key": "MSRC_SEVERITY" - }, - { - "Values": [ - "SecurityUpdates", - "Updates", - "UpdateRollups", - "CriticalUpdates" - ], - "Key": "CLASSIFICATION" + "WindowsServer2016" + ] } ] }, - "ApproveAfterDays": 7 + "ComplianceLevel": "CRITICAL", + "ApproveAfterDays": 0, + "EnableNonSecurity": false } ] }, - "ModifiedDate": 1487872602.453, - "CreatedDate": 1487870482.16, "ApprovedPatches": [ "KB2124261" ], - "Description": "Baseline containing all updates approved for production systems" + "ApprovedPatchesComplianceLevel": "UNSPECIFIED", + "ApprovedPatchesEnableNonSecurity": false, + "RejectedPatches": [ + "KB2032276", + "MS10-048" + ], + "RejectedPatchesAction": "ALLOW_AS_DEPENDENCY", + "CreatedDate": 1550244180.465, + "ModifiedDate": 1550244180.465, + "Description": "Patches for Windows Servers", + "Sources": [] } **To rename a patch baseline** @@ -60,5 +56,5 @@ This example renames a patch baseline. Command:: - aws ssm update-patch-baseline --baseline-id "pb-00dbb759999aa2bc3" --name "Windows-Server-2012-R2-Important-and-Critical-Security-Updates" + aws ssm update-patch-baseline --baseline-id "pb-0713accee01234567" --name "Windows-Server-2012-R2-Important-and-Critical-Security-Updates" \ No newline at end of file diff --git a/bin/awscli/examples/ssm/update-service-setting.rst b/bin/awscli/examples/ssm/update-service-setting.rst new file mode 100644 index 00000000..7edaf860 --- /dev/null +++ b/bin/awscli/examples/ssm/update-service-setting.rst @@ -0,0 +1,12 @@ +**To update the service setting for Parameter Store throughput** + +The following ``update-service-setting`` example updates the current service setting for Parameter Store throughput in the specified region to use increased throughput. :: + + aws ssm update-service-setting \ + --setting-id arn:aws:ssm:us-east-1:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled \ + --setting-value true + +This command produces no output. + +For more information, see `Increasing Parameter Store Throughput `_ in the *AWS Systems Manager User Guide*. + diff --git a/bin/awscli/examples/textract/analyze-document.rst b/bin/awscli/examples/textract/analyze-document.rst new file mode 100755 index 00000000..0944b926 --- /dev/null +++ b/bin/awscli/examples/textract/analyze-document.rst @@ -0,0 +1,59 @@ +**To analyze text in a document** + +The following ``analyze-document`` example shows how to analyze text in a document. :: + + aws textract analyze-document --document '{"S3Object":{"Bucket":"bucket","Name":"document"}}' --feature-types '["TABLES","FORMS"]' + +Output :: + + { + "Blocks": [ + { + "Geometry": { + "BoundingBox": { + "Width": 1.0, + "Top": 0.0, + "Left": 0.0, + "Height": 1.0 + }, + "Polygon": [ + { + "Y": 0.0, + "X": 0.0 + }, + { + "Y": 0.0, + "X": 1.0 + }, + { + "Y": 1.0, + "X": 1.0 + }, + { + "Y": 1.0, + "X": 0.0 + } + ] + }, + "Relationships": [ + { + "Type": "CHILD", + "Ids": [ + "87586964-d50d-43e2-ace5-8a890657b9a0", + "a1e72126-21d9-44f4-a8d6-5c385f9002ba", + "e889d012-8a6b-4d2e-b7cd-7a8b327d876a" + ] + } + ], + "BlockType": "PAGE", + "Id": "c2227f12-b25d-4e1f-baea-1ee180d926b2" + } + ], + "DocumentMetadata": { + "Pages": 1 + } + } + +For more information, see `Analyzing Document Text with Amazon Textract`_ in the *Amazon Textract Developers Guide* + +.. _`Analyzing Document Text with Amazon Textract`: https://docs.aws.amazon.com/textract/latest/dg/analyzing-document-text.html \ No newline at end of file diff --git a/bin/awscli/examples/textract/detect-document-text.rst b/bin/awscli/examples/textract/detect-document-text.rst new file mode 100755 index 00000000..52f623d9 --- /dev/null +++ b/bin/awscli/examples/textract/detect-document-text.rst @@ -0,0 +1,140 @@ +**To detect text in a document** + +The following ``detect-document-text`` The following example shows how to detect text in a document. :: + + aws textract detect-document-text --document '{"S3Object":{"Bucket":"bucket","Name":"document"}}' + +Output :: + + { + "Blocks": [ + { + "Geometry": { + "BoundingBox": { + "Width": 1.0, + "Top": 0.0, + "Left": 0.0, + "Height": 1.0 + }, + "Polygon": [ + { + "Y": 0.0, + "X": 0.0 + }, + { + "Y": 0.0, + "X": 1.0 + }, + { + "Y": 1.0, + "X": 1.0 + }, + { + "Y": 1.0, + "X": 0.0 + } + ] + }, + "Relationships": [ + { + "Type": "CHILD", + "Ids": [ + "896a9f10-9e70-4412-81ce-49ead73ed881", + "0da18623-dc4c-463d-a3d1-9ac050e9e720", + "167338d7-d38c-4760-91f1-79a8ec457bb2" + ] + } + ], + "BlockType": "PAGE", + "Id": "21f0535e-60d5-4bc7-adf2-c05dd851fa25" + }, + { + "Relationships": [ + { + "Type": "CHILD", + "Ids": [ + "62490c26-37ea-49fa-8034-7a9ff9369c9c", + "1e4f3f21-05bd-4da9-ba10-15d01e66604c" + ] + } + ], + "Confidence": 89.11581420898438, + "Geometry": { + "BoundingBox": { + "Width": 0.33642634749412537, + "Top": 0.17169663310050964, + "Left": 0.13885067403316498, + "Height": 0.49159330129623413 + }, + "Polygon": [ + { + "Y": 0.17169663310050964, + "X": 0.13885067403316498 + }, + { + "Y": 0.17169663310050964, + "X": 0.47527703642845154 + }, + { + "Y": 0.6632899641990662, + "X": 0.47527703642845154 + }, + { + "Y": 0.6632899641990662, + "X": 0.13885067403316498 + } + ] + }, + "Text": "He llo,", + "BlockType": "LINE", + "Id": "896a9f10-9e70-4412-81ce-49ead73ed881" + }, + { + "Relationships": [ + { + "Type": "CHILD", + "Ids": [ + "19b28058-9516-4352-b929-64d7cef29daf" + ] + } + ], + "Confidence": 85.5694351196289, + "Geometry": { + "BoundingBox": { + "Width": 0.33182239532470703, + "Top": 0.23131252825260162, + "Left": 0.5091826915740967, + "Height": 0.3766750991344452 + }, + "Polygon": [ + { + "Y": 0.23131252825260162, + "X": 0.5091826915740967 + }, + { + "Y": 0.23131252825260162, + "X": 0.8410050868988037 + }, + { + "Y": 0.607987642288208, + "X": 0.8410050868988037 + }, + { + "Y": 0.607987642288208, + "X": 0.5091826915740967 + } + ] + }, + "Text": "worlc", + "BlockType": "LINE", + "Id": "0da18623-dc4c-463d-a3d1-9ac050e9e720" + } + ], + "DocumentMetadata": { + "Pages": 1 + } + } + +For more information, see `Detecting Document Text with Amazon Textract`_ in the *Amazon Textract Developers Guide* + +.. _`Detecting Document Text with Amazon Textract`: https://docs.aws.amazon.com/textract/latest/dg/detecting-document-text.html \ No newline at end of file diff --git a/bin/awscli/examples/textract/get-document-analysis.rst b/bin/awscli/examples/textract/get-document-analysis.rst new file mode 100755 index 00000000..d74ac57e --- /dev/null +++ b/bin/awscli/examples/textract/get-document-analysis.rst @@ -0,0 +1,62 @@ +**To get the results of asynchronous text analysis of a multi-page document** + +The following ``get-document-analysis`` example shows how to get the results of asynchronous text analysis of a multi-page document. :: + + aws textract get-document-analysis --job-id df7cf32ebbd2a5de113535fcf4d921926a701b09b4e7d089f3aebadb41e0712b --max-results 1000 + +Output :: + + { + "Blocks": [ + { + "Geometry": { + "BoundingBox": { + "Width": 1.0, + "Top": 0.0, + "Left": 0.0, + "Height": 1.0 + }, + "Polygon": [ + { + "Y": 0.0, + "X": 0.0 + }, + { + "Y": 0.0, + "X": 1.0 + }, + { + "Y": 1.0, + "X": 1.0 + }, + { + "Y": 1.0, + "X": 0.0 + } + ] + }, + "Relationships": [ + { + "Type": "CHILD", + "Ids": [ + "75966e64-81c2-4540-9649-d66ec341cd8f", + "bb099c24-8282-464c-a179-8a9fa0a057f0", + "5ebf522d-f9e4-4dc7-bfae-a288dc094595" + ] + } + ], + "BlockType": "PAGE", + "Id": "247c28ee-b63d-4aeb-9af0-5f7ea8ba109e", + "Page": 1 + } + ], + "NextToken": "cY1W3eTFvoB0cH7YrKVudI4Gb0H8J0xAYLo8xI/JunCIPWCthaKQ+07n/ElyutsSy0+1VOImoTRmP1zw4P0RFtaeV9Bzhnfedpx1YqwB4xaGDA==", + "DocumentMetadata": { + "Pages": 1 + }, + "JobStatus": "SUCCEEDED" + } + +For more information, see `Detecting and Analyzing Text in Multi-Page Documents`_ in the *Amazon Textract Developers Guide* + +.. _`Detecting and Analyzing Text in Multi-Page Documents`: https://docs.aws.amazon.com/textract/latest/dg/async.html diff --git a/bin/awscli/examples/textract/get-document-text-detection.rst b/bin/awscli/examples/textract/get-document-text-detection.rst new file mode 100755 index 00000000..52721719 --- /dev/null +++ b/bin/awscli/examples/textract/get-document-text-detection.rst @@ -0,0 +1,62 @@ +**To get the results of asynchronous text detection in a multi-page document** + +The following ``get-document-text-detection`` example shows how to get the results of asynchronous text detection in a multi-page document. :: + + aws textract get-document-text-detection --job-id 57849a3dc627d4df74123dca269d69f7b89329c870c65bb16c9fd63409d200b9 --max-results 1000 + +Output :: + + { + "Blocks": [ + { + "Geometry": { + "BoundingBox": { + "Width": 1.0, + "Top": 0.0, + "Left": 0.0, + "Height": 1.0 + }, + "Polygon": [ + { + "Y": 0.0, + "X": 0.0 + }, + { + "Y": 0.0, + "X": 1.0 + }, + { + "Y": 1.0, + "X": 1.0 + }, + { + "Y": 1.0, + "X": 0.0 + } + ] + }, + "Relationships": [ + { + "Type": "CHILD", + "Ids": [ + "1b926a34-0357-407b-ac8f-ec473160c6a9", + "0c35dc17-3605-4c9d-af1a-d9451059df51", + "dea3db8a-52c2-41c0-b50c-81f66f4aa758" + ] + } + ], + "BlockType": "PAGE", + "Id": "84671a5e-8c99-43be-a9d1-6838965da33e", + "Page": 1 + } + ], + "NextToken": "GcqyoAJuZwujOT35EN4LCI3EUzMtiLq3nKyFFHvU5q1SaIdEBcSty+njNgoWwuMP/muqc96S4o5NzDqehhXvhkodMyVO5OJGyms5lsrCxibWJw==", + "DocumentMetadata": { + "Pages": 1 + }, + "JobStatus": "SUCCEEDED" + } + +For more information, see `Detecting and Analyzing Text in Multi-Page Documents`_ in the *Amazon Textract Developers Guide* + +.. _`Detecting and Analyzing Text in Multi-Page Documents`: https://docs.aws.amazon.com/textract/latest/dg/async.html \ No newline at end of file diff --git a/bin/awscli/examples/textract/start-document-analysis.rst b/bin/awscli/examples/textract/start-document-analysis.rst new file mode 100755 index 00000000..805be8a7 --- /dev/null +++ b/bin/awscli/examples/textract/start-document-analysis.rst @@ -0,0 +1,15 @@ +**To start analyzing text in a multi-page document** + +The following ``start-document-analysis`` example shows how to start asynchronous analysis of text in a multi-page document. :: + + aws textract start-document-analysis --document-location '{"S3Object":{"Bucket":"reescheastv","Name":"doctest.png"}}' --feature-types '["TABLES","FORMS"]' --notification-channel "SNSTopicArn=arn:snsTopic,RoleArn=roleArn" + +Output :: + + { + "JobId": "df7cf32ebbd2a5de113535fcf4d921926a701b09b4e7d089f3aebadb41e0712b" + } + +For more information, see `Detecting and Analyzing Text in Multi-Page Documents`_ in the *Amazon Textract Developers Guide* + +.. _`Detecting and Analyzing Text in Multi-Page Documents`: https://docs.aws.amazon.com/textract/latest/dg/async.html diff --git a/bin/awscli/examples/textract/start-document-text-detection.rst b/bin/awscli/examples/textract/start-document-text-detection.rst new file mode 100755 index 00000000..bf2c3a02 --- /dev/null +++ b/bin/awscli/examples/textract/start-document-text-detection.rst @@ -0,0 +1,15 @@ +**To start detecting text in a multi-page document** + +The following ``start-document-text-detection`` example shows how to start asynchronous detection of text in a multi-page document. :: + + aws textract start-document-text-detection --document-location '{"S3Object":{"Bucket":"reescheastv","Name":"doctest.png"}}' --notification-channel "SNSTopicArn=topicARN,RoleArn=roleARN" + +The command returns output similar to the following. :: + + { + "JobId": "57849a3dc627d4df74123dca269d69f7b89329c870c65bb16c9fd63409d200b9" + } + +For more information, see `Detecting and Analyzing Text in Multi-Page Documents`_ in the *Amazon Textract Developers Guide* + +.. _`Detecting and Analyzing Text in Multi-Page Documents`: https://docs.aws.amazon.com/textract/latest/dg/async.html \ No newline at end of file diff --git a/bin/awscli/examples/waf-regional/associate-web-acl.rst b/bin/awscli/examples/waf-regional/associate-web-acl.rst new file mode 100755 index 00000000..4e9d54d6 --- /dev/null +++ b/bin/awscli/examples/waf-regional/associate-web-acl.rst @@ -0,0 +1,9 @@ +**To associate a web ACL with a resource** + +The following ``associate-web-acl`` command associates a web ACL, specified by the web-acl-id, with a resource, specified by the resource-arn. The resource ARN can refer to either a application load balancer or an API Gateway:: + + aws waf-regional associate-web-acl \ + --web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \ + --resource-arn 12cs345-67cd-890b-1cd2-c3a4567d89f1 + +For more information, see `Working with Web ACLs `__ in the *AWS WAF Developer Guide*. diff --git a/bin/awscli/examples/waf-regional/update-byte-match-set.rst b/bin/awscli/examples/waf-regional/update-byte-match-set.rst new file mode 100755 index 00000000..fe8fc858 --- /dev/null +++ b/bin/awscli/examples/waf-regional/update-byte-match-set.rst @@ -0,0 +1,10 @@ +**To update a byte match set** + +The following ``update-byte-match-set`` command deletes a ``ByteMatchTuple`` object (filter) in a ``ByteMatchSet``. Because the ``updates`` value has embedded double quotes, you must surround the value with single quotes. :: + + aws waf-regional update-byte-match-set \ + --byte-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \ + --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 \ + --updates 'Action="DELETE",ByteMatchTuple={FieldToMatch={Type="HEADER",Data="referer"},TargetString="badrefer1",TextTransformation="NONE",PositionalConstraint="CONTAINS"}' + +For more information, see `Working with String Match Conditions `__ in the *AWS WAF Developer Guide*. diff --git a/bin/awscli/examples/waf-regional/update-ip-set.rst b/bin/awscli/examples/waf-regional/update-ip-set.rst new file mode 100755 index 00000000..136451ad --- /dev/null +++ b/bin/awscli/examples/waf-regional/update-ip-set.rst @@ -0,0 +1,38 @@ +**To update an IP set** + +The following ``update-ip-set`` command updates an IPSet with an IPv4 address and deletes an IPv6 address. Get the value for ``change-token`` by running the ``get-change-token`` command. Because the value for updates includes embedded double-quotes, you must surround the value with single quotes. :: + + aws waf update-ip-set \ + --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \ + --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 \ + --updates 'Action="INSERT",IPSetDescriptor={Type="IPV4",Value="12.34.56.78/16"},Action="DELETE",IPSetDescriptor={Type="IPV6",Value="1111:0000:0000:0000:0000:0000:0000:0111/128"}' + +Alternatively you can use a JSON file to specify the input. For example:: + + aws waf-regional update-ip-set \ + --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \ + --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 \ + --updates file://change.json + +Content of the ``change.json`` :: + + [ + { + "Action": "INSERT", + "IPSetDescriptor": + { + "Type": "IPV4", + "Value": "12.34.56.78/16" + } + }, + { + "Action": "DELETE", + "IPSetDescriptor": + { + "Type": "IPV6", + "Value": "1111:0000:0000:0000:0000:0000:0000:0111/128" + } + } + ] + +For more information, see `Working with IP Match Conditions `__ in the *AWS WAF Developer Guide*. diff --git a/bin/awscli/examples/waf-regional/update-rule.rst b/bin/awscli/examples/waf-regional/update-rule.rst new file mode 100755 index 00000000..c643da54 --- /dev/null +++ b/bin/awscli/examples/waf-regional/update-rule.rst @@ -0,0 +1,10 @@ +**To update a rule** + +The following ``update-rule`` command deletes a ``Predicate`` object in a rule. Because the ``updates`` value has embedded double quotes, you must surround the entire value with single quotes. :: + + aws waf-regional update-rule \ + --rule-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \ + --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 \ + --updates 'Action="DELETE",Predicate={Negated=false,Type="ByteMatch",DataId="MyByteMatchSetID"}' + +For more information, see `Working with Rules `__ in the *AWS WAF Developer Guide* . diff --git a/bin/awscli/examples/waf-regional/update-size-constraint-set.rst b/bin/awscli/examples/waf-regional/update-size-constraint-set.rst new file mode 100755 index 00000000..31492d15 --- /dev/null +++ b/bin/awscli/examples/waf-regional/update-size-constraint-set.rst @@ -0,0 +1,10 @@ +**To update a size constraint set** + +The following ``update-size-constraint-set`` command deletes a `SizeConstraint`` object (filters) in a size constraint set. Because the ``updates`` value contains embedded double quotes, you must surround the entire value with single quotes. :: + + aws waf-regional update-size-constraint-set \ + --size-constraint-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \ + --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 \ + --updates 'Action="DELETE",SizeConstraint={FieldToMatch={Type="QUERY_STRING"},TextTransformation="NONE",ComparisonOperator="GT",Size=0}' + +For more information, see `Working with Size Constraint Conditions `__ in the *AWS WAF Developer Guide*. diff --git a/bin/awscli/examples/waf-regional/update-sql-injection-match-set.rst b/bin/awscli/examples/waf-regional/update-sql-injection-match-set.rst new file mode 100755 index 00000000..6a4a7735 --- /dev/null +++ b/bin/awscli/examples/waf-regional/update-sql-injection-match-set.rst @@ -0,0 +1,10 @@ +**To update a SQL Injection Match Set** + +The following ``update-sql-injection-match-set`` command deletes a ``SqlInjectionMatchTuple`` object (filters) in a SQL injection match set. Because the ``updates`` value contains embedded double quotes, you must surround the entire value in single quotes. : + + aws waf-regional update-sql-injection-match-set \ + --sql-injection-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \ + --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 \ + --updates 'Action="DELETE",SqlInjectionMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"}' + +For more information, see `Working with SQL Injection Match Conditions `__ in the *AWS WAF Developer Guide*. diff --git a/bin/awscli/examples/waf-regional/update-web-acl.rst b/bin/awscli/examples/waf-regional/update-web-acl.rst new file mode 100755 index 00000000..24a8a8e6 --- /dev/null +++ b/bin/awscli/examples/waf-regional/update-web-acl.rst @@ -0,0 +1,11 @@ +**To update a web ACL** + +The following ``update-web-acl`` command deletes an ``ActivatedRule`` object in a WebACL. Because the ``updates`` value contains embedded double quotes, you must surround the entire value in single quotes. :: + + aws waf-regional update-web-acl \ + --web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \ + --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 \ + --updates 'Action="DELETE",ActivatedRule={Priority=1,RuleId="WAFRule-1-Example",Action={Type="ALLOW"},Type="ALLOW"}' + + +For more information, see `Working with Web ACLs `__ in the *AWS WAF Developer Guide*. diff --git a/bin/awscli/examples/waf-regional/update-xss-match-set.rst b/bin/awscli/examples/waf-regional/update-xss-match-set.rst new file mode 100755 index 00000000..1e869403 --- /dev/null +++ b/bin/awscli/examples/waf-regional/update-xss-match-set.rst @@ -0,0 +1,10 @@ +**To update an XSSMatchSet** + +The following ``update-xss-match-set`` command deletes an ``XssMatchTuple`` object (filters) in an ``XssMatchSet``. Because the ``updates`` value contains embedded double quotes, you must surround the entire value with single quotes. :: + + aws waf-regional update-xss-match-set \ + --xss-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 \ + --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 \ + --updates 'Action="DELETE",XssMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"}' + +For more information, see `Working with Cross-site Scripting Match Conditions `__ in the *AWS WAF Developer Guide* . diff --git a/bin/awscli/examples/waf/update-byte-match-set.rst b/bin/awscli/examples/waf/update-byte-match-set.rst index 6f130c78..1dd6e8d7 100755 --- a/bin/awscli/examples/waf/update-byte-match-set.rst +++ b/bin/awscli/examples/waf/update-byte-match-set.rst @@ -1,8 +1,8 @@ **To update a byte match set** -The following ``update-byte-match-set`` command deletes a ByteMatchTuple object (filter) in a ByteMatchSet: +The following ``update-byte-match-set`` command deletes a ByteMatchTuple object (filter) in a ByteMatchSet:: -aws waf update-byte-match-set --byte-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",ByteMatchTuple={FieldToMatch={Type="HEADER",Data="referer"},TargetString="badrefer1",TextTransformation="NONE",PositionalConstraint="CONTAINS"} + aws waf update-byte-match-set --byte-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",ByteMatchTuple={FieldToMatch={Type="HEADER",Data="referer"},TargetString="badrefer1",TextTransformation="NONE",PositionalConstraint="CONTAINS"} diff --git a/bin/awscli/examples/waf/update-ip-set.rst b/bin/awscli/examples/waf/update-ip-set.rst index 4cf0df84..c453badc 100755 --- a/bin/awscli/examples/waf/update-ip-set.rst +++ b/bin/awscli/examples/waf/update-ip-set.rst @@ -8,29 +8,27 @@ Alternatively you can use a JSON file to specify the input. For example:: aws waf update-ip-set --ip-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates file://change.json -Where content of the JSON file is: - -[ -{ -"Action": "INSERT", -"IPSetDescriptor": -{ -"Type": "IPV4", -"Value": "12.34.56.78/16" -} -}, -{ -"Action": "DELETE", -"IPSetDescriptor": -{ -"Type": "IPV6", -"Value": "1111:0000:0000:0000:0000:0000:0000:0111/128" -} -} -] - - - +Where content of the JSON file is:: + + [ + { + "Action": "INSERT", + "IPSetDescriptor": + { + "Type": "IPV4", + "Value": "12.34.56.78/16" + } + }, + { + "Action": "DELETE", + "IPSetDescriptor": + { + "Type": "IPV6", + "Value": "1111:0000:0000:0000:0000:0000:0000:0111/128" + } + } + ] + For more information, see `Working with IP Match Conditions`_ in the *AWS WAF* developer guide. .. _`Working with IP Match Conditions`: https://docs.aws.amazon.com/waf/latest/developerguide/web-acl-ip-conditions.html diff --git a/bin/awscli/examples/waf/update-rule.rst b/bin/awscli/examples/waf/update-rule.rst index 12475dd1..ab086332 100755 --- a/bin/awscli/examples/waf/update-rule.rst +++ b/bin/awscli/examples/waf/update-rule.rst @@ -1,8 +1,10 @@ **To update a rule** -The following ``update-rule`` command deletes a Predicate object in a rule. +The following ``update-rule`` command deletes a Predicate object in a rule:: + + + aws waf update-rule --rule-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",Predicate={Negated=false,Type="ByteMatch",DataId="MyByteMatchSetID"} -aws waf update-rule --rule-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",Predicate="{Negated=false,Type="ByteMatch",DataId="MyByteMatchSetID"}" diff --git a/bin/awscli/examples/waf/update-size-constraint-set.rst b/bin/awscli/examples/waf/update-size-constraint-set.rst index e09d8afc..bcf702be 100755 --- a/bin/awscli/examples/waf/update-size-constraint-set.rst +++ b/bin/awscli/examples/waf/update-size-constraint-set.rst @@ -1,8 +1,8 @@ **To update a size constraint set** -The following ``update-size-constraint-set`` command deletes a SizeConstraint object (filters) in a size constraint set. +The following ``update-size-constraint-set`` command deletes a SizeConstraint object (filters) in a size constraint set:: -aws waf update-size-constraint-set --size-constraint-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",SizeConstraint={FieldToMatch={Type="QUERY_STRING"},TextTransformation="NONE",ComparisonOperator="GT",Size=0} + aws waf update-size-constraint-set --size-constraint-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",SizeConstraint={FieldToMatch={Type="QUERY_STRING"},TextTransformation="NONE",ComparisonOperator="GT",Size=0} diff --git a/bin/awscli/examples/waf/update-sql-injection-match-set.rst b/bin/awscli/examples/waf/update-sql-injection-match-set.rst index a20add1e..bc3c7e9a 100755 --- a/bin/awscli/examples/waf/update-sql-injection-match-set.rst +++ b/bin/awscli/examples/waf/update-sql-injection-match-set.rst @@ -1,8 +1,8 @@ **To update a SQL Injection Match Set** -The following ``update-sql-injection-match-set`` command deletes a SqlInjectionMatchTuple object (filters) in a SQL injection match set. +The following ``update-sql-injection-match-set`` command deletes a SqlInjectionMatchTuple object (filters) in a SQL injection match set:: -aws waf update-sql-injection-match-set --sql-injection-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",SqlInjectionMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"} + aws waf update-sql-injection-match-set --sql-injection-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",SqlInjectionMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"} diff --git a/bin/awscli/examples/waf/update-web-acl.rst b/bin/awscli/examples/waf/update-web-acl.rst index 68f40e50..ac2dffb5 100755 --- a/bin/awscli/examples/waf/update-web-acl.rst +++ b/bin/awscli/examples/waf/update-web-acl.rst @@ -2,7 +2,7 @@ The following ``update-web-acl`` command deletes an ActivatedRule object in a WebACL. -aws waf update-web-acl --web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",ActivatedRule={Priority=1,RuleId="WAFRule-1-Example",Action={Type="ALLOW"},Type="ALLOW"} +aws waf update-web-acl --web-acl-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",ActivatedRule={Priority=1,RuleId="WAFRule-1-Example",Action={Type="ALLOW"},Type="REGULAR"} diff --git a/bin/awscli/examples/waf/update-xss-match-set.rst b/bin/awscli/examples/waf/update-xss-match-set.rst index f568a5ef..b4adca13 100755 --- a/bin/awscli/examples/waf/update-xss-match-set.rst +++ b/bin/awscli/examples/waf/update-xss-match-set.rst @@ -1,8 +1,8 @@ **To update an XSSMatchSet** -The following ``update-xss-match-set`` command deletes an XssMatchTuple object (filters) in an XssMatchSet. +The following ``update-xss-match-set`` command deletes an XssMatchTuple object (filters) in an XssMatchSet:: -aws waf update-xss-match-set --xss-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",XssMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"} + aws waf update-xss-match-set --xss-match-set-id a123fae4-b567-8e90-1234-5ab67ac8ca90 --change-token 12cs345-67cd-890b-1cd2-c3a4567d89f1 --updates Action="DELETE",XssMatchTuple={FieldToMatch={Type="QUERY_STRING"},TextTransformation="URL_DECODE"} diff --git a/bin/awscli/examples/workdocs/initiate-document-version-upload.rst b/bin/awscli/examples/workdocs/initiate-document-version-upload.rst index c15f2fa8..02244e22 100644 --- a/bin/awscli/examples/workdocs/initiate-document-version-upload.rst +++ b/bin/awscli/examples/workdocs/initiate-document-version-upload.rst @@ -1,37 +1,37 @@ -**To initiate a document version upload** - -This example creates a new document object and version object. - -Command:: - - aws workdocs initiate-document-version-upload --name exampledocname --parent-folder-id eacd546d952531c633452ed67cac23161aa0d5df2e8061223a59e8f67e7b6189 - -Output:: - - { - "Metadata": { - "Id": "feaba64d4efdf271c2521b60a2a44a8f057e84beaabbe22f01267313209835f2", - "CreatorId": "S-1-1-11-1111111111-2222222222-3333333333-3333&d-926726012c", - "ParentFolderId": "eacd546d952531c633452ed67cac23161aa0d5df2e8061223a59e8f67e7b6189", - "CreatedTimestamp": 1536773972.914, - "ModifiedTimestamp": 1536773972.914, - "LatestVersionMetadata": { - "Id": "1536773972914-ddb67663e782e7ce8455ebc962217cf9f9e47b5a9a702e5c84dcccd417da9313", - "Name": "exampledocname", - "ContentType": "application/octet-stream", - "Size": 0, - "Status": "INITIALIZED", - "CreatedTimestamp": 1536773972.914, - "ModifiedTimestamp": 1536773972.914, - "CreatorId": "arn:aws:iam::123456789123:user/EXAMPLE" - }, - "ResourceState": "ACTIVE" - }, - "UploadMetadata": { - "UploadUrl": "https://gb-us-west-2-prod-doc-source.s3.us-west-2.amazonaws.com/feaba64d4efdf271c2521b60a2a44a8f057e84beaabbe22f01267313209835f2/1536773972914-ddb67663e782e7ce8455ebc962217cf9f9e47b5a9a702e5c84dcccd417da9313?X-Amz-Algorithm=AWS1-ABCD-EFG234&X-Amz-Date=20180912T173932Z&X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-server-side-encryption&X-Amz-Expires=899&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20180912%2Fus-west-2%2Fs3%2Faws1_request&X-Amz-Signature=01Ab2c34d567e8f90123g456hi78j901k2345678l901234mno56pqr78EXAMPLE", - "SignedHeaders": { - "Content-Type": "application/octet-stream", - "x-amz-server-side-encryption": "ABC123" - } - } -} \ No newline at end of file +**To initiate a document version upload** + +The following ``initiate-document-upload`` example creates a new document object and version object. :: + + aws workdocs initiate-document-version-upload \ + --name exampledocname \ + --parent-folder-id eacd546d952531c633452ed67cac23161aa0d5df2e8061223a59e8f67e7b6189 + +Output:: + + { + "Metadata": { + "Id": "feaba64d4efdf271c2521b60a2a44a8f057e84beaabbe22f01267313209835f2", + "CreatorId": "S-1-1-11-1111111111-2222222222-3333333333-3333&d-926726012c", + "ParentFolderId": "eacd546d952531c633452ed67cac23161aa0d5df2e8061223a59e8f67e7b6189", + "CreatedTimestamp": 1536773972.914, + "ModifiedTimestamp": 1536773972.914, + "LatestVersionMetadata": { + "Id": "1536773972914-ddb67663e782e7ce8455ebc962217cf9f9e47b5a9a702e5c84dcccd417da9313", + "Name": "exampledocname", + "ContentType": "application/octet-stream", + "Size": 0, + "Status": "INITIALIZED", + "CreatedTimestamp": 1536773972.914, + "ModifiedTimestamp": 1536773972.914, + "CreatorId": "arn:aws:iam::123456789123:user/EXAMPLE" + }, + "ResourceState": "ACTIVE" + }, + "UploadMetadata": { + "UploadUrl": "https://gb-us-west-2-prod-doc-source.s3.us-west-2.amazonaws.com/feaba64d4efdf271c2521b60a2a44a8f057e84beaabbe22f01267313209835f2/1536773972914-ddb67663e782e7ce8455ebc962217cf9f9e47b5a9a702e5c84dcccd417da9313?X-Amz-Algorithm=AWS1-ABCD-EFG234&X-Amz-Date=20180912T173932Z&X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-server-side-encryption&X-Amz-Expires=899&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20180912%2Fus-west-2%2Fs3%2Faws1_request&X-Amz-Signature=01Ab2c34d567e8f90123g456hi78j901k2345678l901234mno56pqr78EXAMPLE", + "SignedHeaders": { + "Content-Type": "application/octet-stream", + "x-amz-server-side-encryption": "ABC123" + } + } + } diff --git a/bin/awscli/formatter.py b/bin/awscli/formatter.py index 886017b2..f163f3ad 100644 --- a/bin/awscli/formatter.py +++ b/bin/awscli/formatter.py @@ -231,8 +231,12 @@ def __call__(self, command_name, response, stream=None): try: if is_response_paginated(response): result_keys = response.result_keys - for page in response: - current = {} + for i, page in enumerate(response): + if i > 0: + current = {} + else: + current = response.non_aggregate_part + for result_key in result_keys: data = result_key.search(page) set_value_from_jmespath( diff --git a/bin/awscli/formatter.pyc b/bin/awscli/formatter.pyc deleted file mode 100644 index 2c8e35f5..00000000 Binary files a/bin/awscli/formatter.pyc and /dev/null differ diff --git a/bin/awscli/handlers.py b/bin/awscli/handlers.py index af166a18..d212c693 100644 --- a/bin/awscli/handlers.py +++ b/bin/awscli/handlers.py @@ -86,6 +86,7 @@ from awscli.customizations.servicecatalog import register_servicecatalog_commands from awscli.customizations.s3events import register_event_stream_arg from awscli.customizations.sessionmanager import register_ssm_session +from awscli.customizations.sms_voice import register_sms_voice_hide def awscli_initialize(event_handlers): @@ -174,3 +175,4 @@ def awscli_initialize(event_handlers): register_event_stream_arg(event_handlers) dlm_initialize(event_handlers) register_ssm_session(event_handlers) + register_sms_voice_hide(event_handlers) diff --git a/bin/awscli/handlers.pyc b/bin/awscli/handlers.pyc deleted file mode 100644 index ad8d6b94..00000000 Binary files a/bin/awscli/handlers.pyc and /dev/null differ diff --git a/bin/awscli/help.pyc b/bin/awscli/help.pyc deleted file mode 100644 index a73485a3..00000000 Binary files a/bin/awscli/help.pyc and /dev/null differ diff --git a/bin/awscli/paramfile.py b/bin/awscli/paramfile.py index 975ff97b..7d0a7202 100644 --- a/bin/awscli/paramfile.py +++ b/bin/awscli/paramfile.py @@ -31,8 +31,11 @@ # download the content (i.e TemplateURL in cloudformation). PARAMFILE_DISABLED = set([ 'api-gateway.put-integration.uri', + 'apigatewayv2.create-integration.integration-uri', 'appstream.create-stack.redirect-url', + 'appstream.create-stack.feedback-url', 'appstream.update-stack.redirect-url', + 'appstream.update-stack.feedback-url', 'cloudformation.create-stack.template-url', 'cloudformation.update-stack.template-url', 'cloudformation.create-stack-set.template-url', @@ -83,6 +86,11 @@ 'rds.copy-db-snapshot.pre-signed-url', 'rds.create-db-instance-read-replica.pre-signed-url', + 'sagemaker.create-notebook-instance.default-code-repository', + 'sagemaker.create-notebook-instance.additional-code-repositories', + 'sagemaker.update-notebook-instance.default-code-repository', + 'sagemaker.update-notebook-instance.additional-code-repositories', + 'serverlessapplicationrepository.create-application.home-page-url', 'serverlessapplicationrepository.create-application.license-url', 'serverlessapplicationrepository.create-application.readme-url', diff --git a/bin/awscli/paramfile.pyc b/bin/awscli/paramfile.pyc deleted file mode 100644 index ea70330f..00000000 Binary files a/bin/awscli/paramfile.pyc and /dev/null differ diff --git a/bin/awscli/plugin.pyc b/bin/awscli/plugin.pyc deleted file mode 100644 index 25ff0a7a..00000000 Binary files a/bin/awscli/plugin.pyc and /dev/null differ diff --git a/bin/awscli/schema.pyc b/bin/awscli/schema.pyc deleted file mode 100644 index d67b17d6..00000000 Binary files a/bin/awscli/schema.pyc and /dev/null differ diff --git a/bin/awscli/shorthand.pyc b/bin/awscli/shorthand.pyc deleted file mode 100644 index 1ee53b69..00000000 Binary files a/bin/awscli/shorthand.pyc and /dev/null differ diff --git a/bin/awscli/table.pyc b/bin/awscli/table.pyc deleted file mode 100644 index 3b0e6a8d..00000000 Binary files a/bin/awscli/table.pyc and /dev/null differ diff --git a/bin/awscli/testutils.py b/bin/awscli/testutils.py index faf29484..41bc9174 100644 --- a/bin/awscli/testutils.py +++ b/bin/awscli/testutils.py @@ -211,7 +211,7 @@ def random_chars(num_chars): return binascii.hexlify(os.urandom(int(num_chars / 2))).decode('ascii') -def random_bucket_name(prefix='awscli-s3integ-', num_random=10): +def random_bucket_name(prefix='awscli-s3integ-', num_random=15): """Generate a random S3 bucket name. :param prefix: A prefix to use in the bucket name. Useful @@ -520,7 +520,8 @@ def __init__(self): self.rootdir = tempfile.mkdtemp() def remove_all(self): - shutil.rmtree(self.rootdir) + if os.path.exists(self.rootdir): + shutil.rmtree(self.rootdir) def create_file(self, filename, contents, mtime=None, mode='w'): """Creates a file in a tmpdir @@ -726,6 +727,12 @@ class BaseS3CLICommand(unittest.TestCase): and more streamlined. """ + _PUT_HEAD_SHARED_EXTRAS = [ + 'SSECustomerAlgorithm', + 'SSECustomerKey', + 'SSECustomerKeyMD5', + 'RequestPayer', + ] def setUp(self): self.files = FileCreator() @@ -757,6 +764,7 @@ def create_client_for_bucket(self, bucket_name): return client def assert_key_contents_equal(self, bucket, key, expected_contents): + self.wait_until_key_exists(bucket, key) if isinstance(expected_contents, six.BytesIO): expected_contents = expected_contents.getvalue().decode('utf-8') actual_contents = self.get_key_contents(bucket, key) @@ -788,6 +796,18 @@ def put_object(self, bucket_name, key_name, contents='', extra_args=None): call_args.update(extra_args) response = client.put_object(**call_args) self.addCleanup(self.delete_key, bucket_name, key_name) + extra_head_params = {} + if extra_args: + extra_head_params = dict( + (k, v) for (k, v) in extra_args.items() + if k in self._PUT_HEAD_SHARED_EXTRAS + ) + self.wait_until_key_exists( + bucket_name, + key_name, + extra_params=extra_head_params, + ) + return response def delete_bucket(self, bucket_name, attempts=5, delay=5): self.remove_all_objects(bucket_name) diff --git a/bin/awscli/testutils.pyc b/bin/awscli/testutils.pyc deleted file mode 100644 index 3682c477..00000000 Binary files a/bin/awscli/testutils.pyc and /dev/null differ diff --git a/bin/awscli/text.pyc b/bin/awscli/text.pyc deleted file mode 100644 index 2403d058..00000000 Binary files a/bin/awscli/text.pyc and /dev/null differ diff --git a/bin/awscli/topics/config-vars.rst b/bin/awscli/topics/config-vars.rst index 52964304..207b598c 100644 --- a/bin/awscli/topics/config-vars.rst +++ b/bin/awscli/topics/config-vars.rst @@ -244,6 +244,10 @@ in the AWS CLI config file: maps to the ``RoleSessionName`` parameter in the ``AssumeRole`` operation. This is an optional parameter. If you do not provide this value, a session name will be automatically generated. +* ``duration_seconds`` - 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 is an optional parameter + and by default, the value is set to 3600 seconds. If you do not have MFA authentication required, then you only need to specify a ``role_arn`` and either a ``source_profile`` or a ``credential_source``. diff --git a/bin/awscli/topics/return-codes.rst b/bin/awscli/topics/return-codes.rst index a570150e..e17e7ef4 100644 --- a/bin/awscli/topics/return-codes.rst +++ b/bin/awscli/topics/return-codes.rst @@ -16,7 +16,7 @@ of a CLI command: The primary meaning is that the command entered on the command line failed to be parsed. Parsing failures can be caused by, - but are not limted to, missing any required subcommands or arguments + but are not limited to, missing any required subcommands or arguments or using any unknown commands or arguments. Note that this return code meaning is applicable to all CLI commands. diff --git a/bin/awscli/topics/s3-faq.rst b/bin/awscli/topics/s3-faq.rst index 2ef01cb9..fcf5826f 100644 --- a/bin/awscli/topics/s3-faq.rst +++ b/bin/awscli/topics/s3-faq.rst @@ -25,7 +25,7 @@ not match the ``Content-MD5`` provided, S3 will not store the object and instead will return an error message back the AWS CLI. The AWS CLI will retry this error up to 5 times before giving up. On the case that any files fail to transfer successfully to S3, the AWS CLI will exit with a non zero RC. -See ``aws help returncodes`` for more information. +See ``aws help return-codes`` for more information. If the upload request is signed with Signature Version 4, then a ``Content-MD5`` is not calculated. Instead, the AWS CLI uses the @@ -52,7 +52,7 @@ performed whenever the AWS CLI downloads objects from S3. If the calculated MD5 checksum does not match the expected checksum, the file is deleted and the download is retried. This process is retried up to 3 times. If a downloads fails, the AWS CLI will exit with a non zero RC. -See ``aws help returncodes`` for more information. +See ``aws help return-codes`` for more information. There are several conditions where the CLI is *not* able to verify checksums on downloads: diff --git a/bin/awscli/topictags.pyc b/bin/awscli/topictags.pyc deleted file mode 100644 index 2f46e599..00000000 Binary files a/bin/awscli/topictags.pyc and /dev/null differ diff --git a/bin/awscli/utils.pyc b/bin/awscli/utils.pyc deleted file mode 100644 index d7780ce4..00000000 Binary files a/bin/awscli/utils.pyc and /dev/null differ diff --git a/bin/bc b/bin/bc new file mode 100755 index 00000000..681431f7 Binary files /dev/null and b/bin/bc differ diff --git a/bin/botocore-1.12.61.dist-info/DESCRIPTION.rst b/bin/botocore-1.12.61.dist-info/DESCRIPTION.rst deleted file mode 100644 index 43951845..00000000 --- a/bin/botocore-1.12.61.dist-info/DESCRIPTION.rst +++ /dev/null @@ -1,35 +0,0 @@ -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 `here `__. - - -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 `__ - - diff --git a/bin/botocore-1.12.61.dist-info/INSTALLER b/bin/botocore-1.12.61.dist-info/INSTALLER deleted file mode 100644 index a1b589e3..00000000 --- a/bin/botocore-1.12.61.dist-info/INSTALLER +++ /dev/null @@ -1 +0,0 @@ -pip diff --git a/bin/botocore-1.12.61.dist-info/METADATA b/bin/botocore-1.12.61.dist-info/METADATA deleted file mode 100644 index 1b81e360..00000000 --- a/bin/botocore-1.12.61.dist-info/METADATA +++ /dev/null @@ -1,70 +0,0 @@ -Metadata-Version: 2.0 -Name: botocore -Version: 1.12.61 -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 -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 -Requires-Dist: python-dateutil>=2.1,<2.7.0; python_version=="2.6" -Requires-Dist: python-dateutil>=2.1,<3.0.0; python_version>="2.7" -Requires-Dist: jmespath>=0.7.1,<1.0.0 -Requires-Dist: docutils>=0.10 -Requires-Dist: ordereddict==1.1; python_version=="2.6" -Requires-Dist: simplejson==3.3.0; python_version=="2.6" -Requires-Dist: urllib3>=1.20,<1.23; python_version=="3.3" -Requires-Dist: urllib3>=1.20,<1.24; python_version=="2.6" -Requires-Dist: urllib3>=1.20,<1.25; python_version=="2.7" -Requires-Dist: urllib3>=1.20,<1.25; python_version>="3.4" - -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 `here `__. - - -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 `__ - - diff --git a/bin/botocore-1.12.61.dist-info/RECORD b/bin/botocore-1.12.61.dist-info/RECORD deleted file mode 100644 index 4056fc2d..00000000 --- a/bin/botocore-1.12.61.dist-info/RECORD +++ /dev/null @@ -1,799 +0,0 @@ -botocore/httpsession.py,sha256=-uQTGVdeXg2bcn__25HLBeBNAh5hCl6j0BIGt1B7bpE,11273 -botocore/stub.py,sha256=iBH29Z62abIMUi-8QCDXz80bqnUkoDvJV9juPb37pQs,14360 -botocore/serialize.py,sha256=489TJ8Yd2j2GylMOk8w7-lp203wkkixXE01U9PxpHr0,29815 -botocore/auth.py,sha256=eRw52rgV0JpJYRcpxACW1iwMRda0ORAa3v1P_CL4ef0,35536 -botocore/model.py,sha256=wQ5_EfpfdOS48GdQ0uUa41UOxJ847i_WzQaoNSU6asw,25630 -botocore/errorfactory.py,sha256=NnN3nOViM4CWXRH7lVbjwyDVF3xnX3HZaw6iaVAhCa0,4091 -botocore/loaders.py,sha256=JvpfDdPCJvMJgxwPEo7iTPXJa3Q2-ubJ-VepCTYmVz4,17355 -botocore/regions.py,sha256=59Jcy3XRsgCJx7SJ3XCYhtABkI9K1KAe6CVxciGpd3E,8420 -botocore/awsrequest.py,sha256=SjedU52k7TstcacYdTkgzazw4_Og0RLUJDJtnrdjwPw,24722 -botocore/retryhandler.py,sha256=KmT3OA-x3IWxNegMF7j1Yz5C5vuybCsZvcSkXc2XNd8,13781 -botocore/hooks.py,sha256=1iYWMRy2AkhMgY7TLHP97-FSfLbtewu5LXyfXLWK_yQ,24573 -botocore/waiter.py,sha256=HqQBkmuRRYFFjG4TRMX-ziJqgq2CI_triqzVdsf-u8g,12418 -botocore/credentials.py,sha256=C94LN7B22hNLN4lIdC9qAO-lhJMQbtwcPE6yJXM9B7Y,64852 -botocore/exceptions.py,sha256=GKHYIoc74xROVi80MAKFrFmIRpC0Uov5P6nUcaLqjTQ,15663 -botocore/eventstream.py,sha256=YFjerdOepceQWlCUYbFyF6F75iCXVnSxYJIXvfJKkSA,19087 -botocore/configprovider.py,sha256=y_DiQViKv7AnXPSnabk9HID6cQiHfvvSa_NwdIdIScs,16365 -botocore/endpoint.py,sha256=Gi1xmhKedwLiKSqsIANSnohbqxArA1hs7okoPxigRiA,11653 -botocore/signers.py,sha256=DSw4x_olWuE7AfJYrdygih2f5qN_tYjhpiZSrOQSaBc,27709 -botocore/cacert.pem,sha256=7CEXfLHxDwvDpwVu0y_2lfJYk63cU-KUKI_DL1Lq8Uo,271088 -botocore/utils.py,sha256=8k3Q1IiBs_ofeEVgm72Tc_nWRSmjPiJPco75jJ_el28,49826 -botocore/session.py,sha256=c-XxzZS79z47tuNvoxPeafbu82qGPzY1O9m9G6blXmo,41106 -botocore/handlers.py,sha256=oEfX82IynWRjB0YRaDNx2zPGbS-GUeglLnkpZFMleL4,45560 -botocore/response.py,sha256=C6VGeOhGnbne7iOAkqV82VbINOuLlr7n-3jIbXALym4,6455 -botocore/config.py,sha256=rtXn9RPqnDmG4OQ0H1Mv4I210NYN8lSpIbbldjdZjcU,9609 -botocore/paginate.py,sha256=qCwIpG2uhB_YhmVZRQrlpjXFX0NaT4_JL01W10wpwBU,27057 -botocore/compat.py,sha256=oPlxAIqhufv8JoExOweS8aAtec_AjHEvEUgEYbGh9x4,13262 -botocore/args.py,sha256=pM7UhjyiayGdIMlJ5w_gXus-CvTNXnONf9lzy1Q_kMk,10213 -botocore/validate.py,sha256=U3QLMYSVz_TX2mWUY-Fe_RzgZiwdrf7HemgAlqxC5qc,11501 -botocore/translate.py,sha256=RteQ6FyDou98NspaETe6zyGextA_48CjrSFwDDLm65c,3412 -botocore/parsers.py,sha256=55mQw5lH-FRIky4jNwW72l9FnHCV6CG9KDrWCW4qi3g,38807 -botocore/__init__.py,sha256=A0LoHSURVXQqQqovwozOdSvC3aInBo6s30q4WSoNdf4,3487 -botocore/configloader.py,sha256=MqSNXs8Mw8nBaXkNSI7GhdVqAKGxJ4o5XbcHzgFMpsc,9558 -botocore/history.py,sha256=mM6u8qvmPpvYRLEaZi8O0sBFygw3p647kAtBuHfjfFI,1748 -botocore/client.py,sha256=f9L8VECUAgYFEEjvA5MpNbunHeYKI8pjL0iHlEnMsRc,38638 -botocore/vendored/six.py,sha256=A6hdJZVjI3t_geebZ9BzUvwRrIXo0lfwzQlM2LcKyas,30098 -botocore/vendored/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -botocore/vendored/requests/structures.py,sha256=i3yMaaDbl4_gNJKdcK3kDmeSLoo0r59XEIWoc_qtNyo,2977 -botocore/vendored/requests/auth.py,sha256=pD2td_DoHl-YWQQITk5ZPSKjsR5_sBxRkseYMx1n704,6794 -botocore/vendored/requests/api.py,sha256=X8Znh82s62_3FBPFkqafNQn7s4L-5q8-GLclLKKHs3I,5415 -botocore/vendored/requests/hooks.py,sha256=9vNiuiRHRd5Qy6BX_0p1H3NsUzDo1M_HaFR2AFL41Tg,820 -botocore/vendored/requests/certs.py,sha256=RX5H1cSiB52Hbjh_qv3eMW8hqHEF_r4Qiv_4AwfziuU,613 -botocore/vendored/requests/exceptions.py,sha256=zZhHieXgR1teqbvuo_9OrwDMHnrvRtulW97VfzumQv4,2517 -botocore/vendored/requests/models.py,sha256=_vxB3Z3QDkV_HYcZFqFrPq31TmworMeYEM094Q9Vf00,29176 -botocore/vendored/requests/adapters.py,sha256=MEedP-slXqxDnYdi4JxuCE3y2NTizShvL_SfP3ncge4,16810 -botocore/vendored/requests/cacert.pem,sha256=7CEXfLHxDwvDpwVu0y_2lfJYk63cU-KUKI_DL1Lq8Uo,271088 -botocore/vendored/requests/utils.py,sha256=yh5am9D9nG_oAYyYU2upkXIth2QOi1LJhiHSx5dSVbw,21334 -botocore/vendored/requests/sessions.py,sha256=kWfupbWN_Uhu-FKPEc7y1NyvyQNE5jryuA5Uad2Yy0U,24250 -botocore/vendored/requests/status_codes.py,sha256=DVA33t4UthIiZhP4iYSChbWjuhrJWvVA04qle9nwj2Q,3200 -botocore/vendored/requests/compat.py,sha256=hq7CKHoykNs8yzKPAJiOkHQJPoNp9A89MufTdhlCniY,1469 -botocore/vendored/requests/__init__.py,sha256=3TJHLc9RZ_3QCQYiP0r9lshzLMIdLm1gn0wVwNqaZmg,1861 -botocore/vendored/requests/cookies.py,sha256=Um1lXApUUO0-P6U1TOudXu1cYVXBFN77f16OFxiIAt8,17191 -botocore/vendored/requests/packages/__init__.py,sha256=aXkbNCjM_WhryRBocE4AaA_p7-CTxL5LOutY7XzKm4s,62 -botocore/vendored/requests/packages/chardet/hebrewprober.py,sha256=8pdoUfsVXf_L4BnJde_BewS6H2yInV5688eu0nFhLHY,13359 -botocore/vendored/requests/packages/chardet/gb2312prober.py,sha256=VWnjoRa83Y6V6oczMaxyUr0uy48iCnC2nzk9zfEIRHc,1681 -botocore/vendored/requests/packages/chardet/constants.py,sha256=-UnY8U7EP7z9fTyd09yq35BEkSFEAUAiv9ohd1DW1s4,1335 -botocore/vendored/requests/packages/chardet/latin1prober.py,sha256=238JHOxH8aRudJY2NmeSv5s7i0Qe3GuklIU3HlYybvg,5232 -botocore/vendored/requests/packages/chardet/chardetect.py,sha256=f4299UZG6uWd3i3r_N0OdrFj2sA9JFI54PAmDLAFmWA,2504 -botocore/vendored/requests/packages/chardet/mbcharsetprober.py,sha256=9rOCjDVsmSMp6e7q2syqak22j7lrbUZhJhMee2gbVL0,3268 -botocore/vendored/requests/packages/chardet/big5freq.py,sha256=D8oTdz-GM7Jg8TsaWJDm65vM_OLHC3xub6qUJ3rOgsQ,82594 -botocore/vendored/requests/packages/chardet/jisfreq.py,sha256=ZcL4R5ekHHbP2KCYGakVMBsiKqZZZAABzhwi-uRkOps,47315 -botocore/vendored/requests/packages/chardet/euckrfreq.py,sha256=T5saK5mImySG5ygQPtsp6o2uKulouCwYm2ElOyFkJqU,45978 -botocore/vendored/requests/packages/chardet/chardistribution.py,sha256=cUARQFr1oTLXeJCDQrDRkUP778AvSMzhSCnG8VLCV58,9226 -botocore/vendored/requests/packages/chardet/langgreekmodel.py,sha256=QHMy31CH_ot67UCtmurCEKqKx2WwoaKrw2YCYYBK2Lw,12628 -botocore/vendored/requests/packages/chardet/sbcsgroupprober.py,sha256=8hLyH8RAG-aohBo7o_KciWVgRo42ZE_zEtuNG1JMRYI,3291 -botocore/vendored/requests/packages/chardet/euctwprober.py,sha256=upS2P6GuT5ujOxXYw-RJLcT7A4PTuo27KGUKU4UZpIQ,1676 -botocore/vendored/requests/packages/chardet/big5prober.py,sha256=XX96C--6WKYW36mL-z7pJSAtc169Z8ZImByCP4pEN9A,1684 -botocore/vendored/requests/packages/chardet/euctwfreq.py,sha256=G_I0BW9i1w0ONeeUwIYqV7_U09buIHdqh-wNHVaql7I,34872 -botocore/vendored/requests/packages/chardet/jpcntx.py,sha256=yftmp0QaF6RJO5SJs8I7LU5AF4rwP23ebeCQL4BM1OY,19348 -botocore/vendored/requests/packages/chardet/euckrprober.py,sha256=Wo7dnZ5Erw_nB4H-m5alMiOxOuJUmGHlwCSaGqExDZA,1675 -botocore/vendored/requests/packages/chardet/langhebrewmodel.py,sha256=4ASl5vzKJPng4H278VHKtRYC03TpQpenlHTcsmZH1rE,11318 -botocore/vendored/requests/packages/chardet/escsm.py,sha256=7iljEKN8lXTh8JFXPUSwlibMno6R6ksq4evLxbkzfro,7839 -botocore/vendored/requests/packages/chardet/universaldetector.py,sha256=h-E2x6XSCzlNjycYWG0Fe4Cf1SGdaIzUNu2HCphpMZA,6840 -botocore/vendored/requests/packages/chardet/escprober.py,sha256=q5TcQKeVq31WxrW7Sv8yjpZkjEoaHO8S92EJZ9hodys,3187 -botocore/vendored/requests/packages/chardet/utf8prober.py,sha256=7tdNZGrJY7jZUBD483GGMkiP0Tx8Fp-cGvWHoAsilHg,2652 -botocore/vendored/requests/packages/chardet/sbcharsetprober.py,sha256=Xq0lODqJnDgxglBiQI4BqTFiPbn63-0a5XNA5-hVu7U,4793 -botocore/vendored/requests/packages/chardet/langcyrillicmodel.py,sha256=fkcd5OvogUp-GrNDWAZPgkYsSRCD2omotAEvqjlmLKE,17725 -botocore/vendored/requests/packages/chardet/langhungarianmodel.py,sha256=SXwuUzh49_cBeMXhshRHdrhlkz0T8_pZWV_pdqBKNFk,12536 -botocore/vendored/requests/packages/chardet/codingstatemachine.py,sha256=E85rYhHVMw9xDEJVgiQhp0OnLGr6i2r8_7QOWMKTH08,2318 -botocore/vendored/requests/packages/chardet/eucjpprober.py,sha256=5IpfSEjAb7h3hcGMd6dkU80O900C2N6xku28rdYFKuc,3678 -botocore/vendored/requests/packages/chardet/cp949prober.py,sha256=FMvdLyB7fejPXRsTbca7LK1P3RUvvssmjUNyaEfz8zY,1782 -botocore/vendored/requests/packages/chardet/mbcssm.py,sha256=IKwJXyxu34n6NojmxVxC60MLFtJKm-hIfxaFEnb3uBA,19590 -botocore/vendored/requests/packages/chardet/gb2312freq.py,sha256=M2gFdo_qQ_BslStEchrPW5CrPEZEacC0uyDLw4ok-kY,36011 -botocore/vendored/requests/packages/chardet/charsetgroupprober.py,sha256=0lKk7VE516fgMw119tNefFqLOxKfIE9WfdkpIT69OKU,3791 -botocore/vendored/requests/packages/chardet/sjisprober.py,sha256=UYOmiMDzttYIkSDoOB08UEagivJpUXz4tuWiWzTiOr8,3764 -botocore/vendored/requests/packages/chardet/mbcsgroupprober.py,sha256=SHRzNPLpDXfMJLA8phCHVU0WgqbgDCNxDQMolGX_7yk,1967 -botocore/vendored/requests/packages/chardet/compat.py,sha256=5mm6yrHwef1JEG5OxkPJlSq5lkjLVpEGh3iPgFBkpkM,1157 -botocore/vendored/requests/packages/chardet/langbulgarianmodel.py,sha256=ZyPsA796MSVhYdfWhMCgKWckupAKAnKqWcE3Cl3ej6o,12784 -botocore/vendored/requests/packages/chardet/langthaimodel.py,sha256=-k7djh3dGKngAGnt3WfuoJN7acDcWcmHAPojhaUd7q4,11275 -botocore/vendored/requests/packages/chardet/__init__.py,sha256=XuTKCYOR7JwsoHxqZTYH86LVyMDbDI3s1s0W_qoGEBM,1295 -botocore/vendored/requests/packages/chardet/charsetprober.py,sha256=Z48o2KiOj23FNqYH8FqzhH5m1qdm3rI8DcTm2Yqtklg,1902 -botocore/vendored/requests/packages/urllib3/connectionpool.py,sha256=kGlpxwc2lRax0J7f2tFVWjXefCIdIWyLHqHDa6amN7A,30319 -botocore/vendored/requests/packages/urllib3/filepost.py,sha256=TEpQ_PMO0loPQERLr4E7VcgbMfhNwOCxt8cudhrpkM0,2281 -botocore/vendored/requests/packages/urllib3/poolmanager.py,sha256=Qw1UStRXPh6RH5BOT7x4NY7Gqkho2njYEDiqk9_8728,9406 -botocore/vendored/requests/packages/urllib3/exceptions.py,sha256=za-cEwBqxBKOqqKTaIVAMdH3j1nDRqi-MtdojdpU4Wc,4374 -botocore/vendored/requests/packages/urllib3/connection.py,sha256=uqwsV351AZqV008fb7OscFbyZt6dRicjQQrUA0K01iw,9011 -botocore/vendored/requests/packages/urllib3/response.py,sha256=t4Pl6JVQ9jYXbriu0cQf5dRuRSpxSP9YltgMu35JFPo,16459 -botocore/vendored/requests/packages/urllib3/request.py,sha256=NjnLVqcKZVotmPV335m87AqMFBSH0V_ml2tOGxKSKRI,5751 -botocore/vendored/requests/packages/urllib3/fields.py,sha256=06XgBjTvEyVYUWA-j_6zhnfXMpd-IxZdzT85ppAFfYg,5833 -botocore/vendored/requests/packages/urllib3/__init__.py,sha256=WdpCLx5juBoMArBMbVT125BD8SvK-Id9Js57PTnpfSs,2055 -botocore/vendored/requests/packages/urllib3/_collections.py,sha256=tatXHmN5An3gw-alS68qs3yO_vweJ8eFTUmwMXvlKpQ,10454 -botocore/vendored/requests/packages/urllib3/packages/six.py,sha256=U-rO-WBrFS8PxHeamSl6okKCjqPF18NhiZb0qPZ67XM,11628 -botocore/vendored/requests/packages/urllib3/packages/ordered_dict.py,sha256=VQaPONfhVMsb8B63Xg7ZOydJqIE_jzeMhVN3Pec6ogw,8935 -botocore/vendored/requests/packages/urllib3/packages/__init__.py,sha256=EKCTAOjZtPR_HC50e7X8hS5j4bkFkN87XZOT-Wdpfus,74 -botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/_implementation.py,sha256=fK28k37hL7-D79v9iM2fHgNK9Q1Pw0M7qVRL4rkfFjQ,3778 -botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/__init__.py,sha256=cOWMIn1orgJoA35p6pSzO_-Dc6iOX9Dhl6D2sL9b_2o,460 -botocore/vendored/requests/packages/urllib3/contrib/ntlmpool.py,sha256=F29BjpIMId2u9Bwmy0bmg8eDYKvQZiXLsZeK2cDNctQ,4507 -botocore/vendored/requests/packages/urllib3/contrib/pyopenssl.py,sha256=ooNMMfp9cEirGyLRcIE-f-qidQPdDp2kBl-K5ALOJyU,9326 -botocore/vendored/requests/packages/urllib3/contrib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -botocore/vendored/requests/packages/urllib3/util/connection.py,sha256=PTxckPfstrFVAPAfYn12kaZYEfoQn-CDCo2VrIBPtpo,3293 -botocore/vendored/requests/packages/urllib3/util/ssl_.py,sha256=X4mp-FA-Jact7Z3sEzxenQ69Jnwlz2-G7gjJXL1CMdw,10037 -botocore/vendored/requests/packages/urllib3/util/timeout.py,sha256=2MqJVD_v_0tLxgm2Mr_ePqYmfnB5zjZXphlIexWocKM,9544 -botocore/vendored/requests/packages/urllib3/util/url.py,sha256=uPcy_lCMdmQhdofnemWyjYjHsPJaZ0VisANa2vaCr3g,5836 -botocore/vendored/requests/packages/urllib3/util/response.py,sha256=QMrOy69WPkoe42EU0Y5jwRNqBf-w1FF8GJWAx1jQDmY,566 -botocore/vendored/requests/packages/urllib3/util/request.py,sha256=zY2x5tBXzvgLWgF3XRk_CEk-X8Q8L9bqpESqWn13I_0,2089 -botocore/vendored/requests/packages/urllib3/util/__init__.py,sha256=zrB1BFTNOUWxgEVvZlicK8uEU2AVpT1TFmWo2gQGfDA,486 -botocore/vendored/requests/packages/urllib3/util/retry.py,sha256=bcRb3QC1LDMHLx8gBDDGFqZ3dKs6bYcpfWZJ3FpOMtE,9924 -botocore/docs/shape.py,sha256=DUPvgKgDPNZR8jWAwSMh1rPnjAhVOP1c8vOSNunaAAM,4994 -botocore/docs/paginator.py,sha256=5zFXpJDsDmmtupttiFB1nNzP9OEephKY6qsd8jdlk0E,6986 -botocore/docs/docstring.py,sha256=8_HzHVdKsIxM2fqMO1AF0dP9mhjBb7kUPISlLxedGe4,3699 -botocore/docs/method.py,sha256=pGjAUCiqD8TDGkaNrA7hlwYAs4m4ZlMXLRFTfRnr1HY,11549 -botocore/docs/waiter.py,sha256=2JwQel4QVkuuOT4pm-jb9NgQnZHRWoZMcjsaMuZmm6o,4823 -botocore/docs/utils.py,sha256=Iu72WFt__x44s-U2_VitHBFmEr-Ky-Nz_c3b5syoyjY,7176 -botocore/docs/service.py,sha256=9Gaxv166aCon2TMKWFfTjS7K9ueJ2HtY3asOq1c-IVc,3480 -botocore/docs/sharedexample.py,sha256=RWe-sQv6gQAMfs8NsIppWQmftd0eriLaEnKhcVKVzkE,9326 -botocore/docs/params.py,sha256=ZDWQacPeYjFo13cflN0c1a60IXBOqpZYjZDb1p3Z26w,9561 -botocore/docs/__init__.py,sha256=u8q1PqNQdRnL9XMgVAGKLSp_wJOLBBum7EiDFS_zUfQ,1543 -botocore/docs/example.py,sha256=-zLJxpQGMoIcnlmMpDi_ksjKmqvWS6e8B_UzRYbVwA4,8751 -botocore/docs/client.py,sha256=BPPwUimIsiMLflHv5RkC1nRtQ-BkE59opfTW0QWUG9E,4673 -botocore/docs/bcdoc/restdoc.py,sha256=5xUdalLFANMoPwB3J6iMdMJhVO7WYb1X-sT7cVgI3LM,7226 -botocore/docs/bcdoc/style.py,sha256=Zf7DB_WSQgfseH3mnXMqKkE0Q8eC_iNYw3w_Pkx63os,11833 -botocore/docs/bcdoc/docstringparser.py,sha256=jrOjpdwkZCGh04gIoLBpP9QAXmR9V3I1yjHxQz9IOMM,5889 -botocore/docs/bcdoc/textwriter.py,sha256=z6WyK2qm-f4xWFZhcAc_Dori_XrrSsIdkkITQ61De_w,20611 -botocore/docs/bcdoc/__init__.py,sha256=V2g87AefB2DOD9_3xIF5k9Nv5ttb4_gNJOVvSF0Mp3s,588 -botocore/docs/bcdoc/docevents.py,sha256=q74aXqhYPXAGRwx9hKKRqOJ-SkdMQnZL6PI9TPLsK2Y,4733 -botocore/data/_retry.json,sha256=cEPP2IBVvtzW59rXPRI0l1Bg-nQGLKHaMEc3nOLnxbA,6444 -botocore/data/endpoints.json,sha256=n6RS29rr7Rwd0e2e0H3RIZOVVD8RVfp11wb1LCERrFs,89731 -botocore/data/lightsail/2016-11-28/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/lightsail/2016-11-28/paginators-1.json,sha256=iTn2ixIp2desYfltedGcnARJ3kDUyhaUT_uV05mXfCI,1245 -botocore/data/lightsail/2016-11-28/service-2.json,sha256=IXRYfNmq78cRT8XT0yNmvEc1GIa_LaUAguGW81oCeng,308634 -botocore/data/mobile/2017-07-01/paginators-1.json,sha256=QWwTFfnKV_AnwK-xCcXFK6bJDEHfSe4A8ollJulmrpE,350 -botocore/data/mobile/2017-07-01/service-2.json,sha256=iN_C36LA8aSC3y4YfUR6Y7XotVWLN21y9loCSWP3S6o,27007 -botocore/data/waf-regional/2016-11-28/examples-1.json,sha256=6OPuCnLynJIfGO-Vxhb9ZZV9ktEKhpByvf2jSwAg-DY,29749 -botocore/data/waf-regional/2016-11-28/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/waf-regional/2016-11-28/service-2.json,sha256=Ajwq7vF_DFVwgq0kDQc152SpENS_XtGPAHXJ0JBEBMU,318475 -botocore/data/ec2/2015-03-01/waiters-2.json,sha256=UDhKYGIrItEq2e56vKMh6yLdn_YfsfTYsmankCjsR3k,11040 -botocore/data/ec2/2015-03-01/paginators-1.json,sha256=Uns0O6V6ZIXI09iZdCY77w-CBHbes_siW5vFU-bpE1w,1439 -botocore/data/ec2/2015-03-01/service-2.json,sha256=yg7MGHYAL-yI2xA5dZ1_-FyPWLh_C8ZvRJfV0ZSW-Z4,588390 -botocore/data/ec2/2016-11-15/examples-1.json,sha256=Dv18Ql8faOeBMQlenC7HBzlgrNQXNeokvLsyFf6Q_yY,110174 -botocore/data/ec2/2016-11-15/waiters-2.json,sha256=QcLUdyeAw3YbqHVY5kg30lkT_DFXag2rwL8cgka1qWo,15709 -botocore/data/ec2/2016-11-15/paginators-1.json,sha256=-eHtmlAmocp-yzga8qPi-4jM8s_2KGUoMlHek3dRbqk,2892 -botocore/data/ec2/2016-11-15/service-2.json,sha256=G0yexyVDvMIR2WCB9tK1E1f19BrUhR2QYC36bVRusk0,1369377 -botocore/data/ec2/2015-10-01/waiters-2.json,sha256=8sXo9xWtm1IZMKcm9Ne42ha-9XDTVP_fZUejgA1tw3E,14823 -botocore/data/ec2/2015-10-01/paginators-1.json,sha256=Vom5HeCc0UgDyEyYKw3piztolJ3IIxz_tIhEX61TvM8,1793 -botocore/data/ec2/2015-10-01/service-2.json,sha256=dmQdClL90tFYkUzQeHRAWyb5Ae_YsUV2urf5lYe9Rxs,847080 -botocore/data/ec2/2016-09-15/examples-1.json,sha256=Dv18Ql8faOeBMQlenC7HBzlgrNQXNeokvLsyFf6Q_yY,110174 -botocore/data/ec2/2016-09-15/waiters-2.json,sha256=1ZtptOEInU4p-4ZQFXbC5lxZ8XNsseki72qxLO2dX4M,14875 -botocore/data/ec2/2016-09-15/paginators-1.json,sha256=Vom5HeCc0UgDyEyYKw3piztolJ3IIxz_tIhEX61TvM8,1793 -botocore/data/ec2/2016-09-15/service-2.json,sha256=40e47h21ZRjZDx_8gm3nUT8Lr9G31mnyADMBeR-EPok,891280 -botocore/data/ec2/2014-09-01/waiters-2.json,sha256=HG1xDu-8ICfvY1n_YV9i0ylufepFUYmDd0dLkQxwKuY,8548 -botocore/data/ec2/2014-09-01/paginators-1.json,sha256=XpA8TZvmBGGraKlRGE-U-YeLIBN1ZvbcyE8Wh8uuIDM,1271 -botocore/data/ec2/2014-09-01/service-2.json,sha256=g3DViTT4mmGeKxoN0bqbl-0AndJID1vh5iOnhJcATlk,539923 -botocore/data/ec2/2016-04-01/waiters-2.json,sha256=ZjSjdDS-pisO_MoRjsulXMshrcU5qNJd4m1bOBQ9mKQ,15259 -botocore/data/ec2/2016-04-01/paginators-1.json,sha256=Vom5HeCc0UgDyEyYKw3piztolJ3IIxz_tIhEX61TvM8,1793 -botocore/data/ec2/2016-04-01/service-2.json,sha256=YGX9U8JvAjWHLZnONpuJFyNJ5sMEilCiu9A8oPJqA1M,878250 -botocore/data/ec2/2015-04-15/waiters-2.json,sha256=1iUHJTDrTvb5_HbDMbVVzC4Ex1S97GZl-tnP70MaDEY,11546 -botocore/data/ec2/2015-04-15/paginators-1.json,sha256=Uns0O6V6ZIXI09iZdCY77w-CBHbes_siW5vFU-bpE1w,1439 -botocore/data/ec2/2015-04-15/service-2.json,sha256=GgdUgnyrx65mPXWHdUX1CxBrdQkUVuQkIFufN6tIHiA,715324 -botocore/data/ec2/2014-10-01/waiters-2.json,sha256=UDhKYGIrItEq2e56vKMh6yLdn_YfsfTYsmankCjsR3k,11040 -botocore/data/ec2/2014-10-01/paginators-1.json,sha256=Uns0O6V6ZIXI09iZdCY77w-CBHbes_siW5vFU-bpE1w,1439 -botocore/data/ec2/2014-10-01/service-2.json,sha256=SJQZUwN8Poi1qZjoKekkUDZMzxVgh1JEezXu85AuPX4,566499 -botocore/data/cloudhsm/2014-05-30/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cloudhsm/2014-05-30/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/cloudhsm/2014-05-30/service-2.json,sha256=2R1wH2l1s28qBul0DGHm5Os0OqdaqxbmcRfBDz7YUfQ,55315 -botocore/data/iot-data/2015-05-28/service-2.json,sha256=A-tl_4fifm5j5_njOZEveLO3H5fFAWy71RiXQfu9vi0,11389 -botocore/data/codepipeline/2015-07-09/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/codepipeline/2015-07-09/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/codepipeline/2015-07-09/service-2.json,sha256=9ryu7E4NReJIvlKxVom4AQHYjTHPS-bksDEJfkLoLP4,124682 -botocore/data/elb/2012-06-01/examples-1.json,sha256=NE6HcGypE87pOfvGkxKi_QD-UJ_qWHG2_Q9ynk6V9xA,30446 -botocore/data/elb/2012-06-01/waiters-2.json,sha256=9NjB-6qbZ5pHxElH90T-4YPEBdXHCA9QHdcF96gTbP0,1527 -botocore/data/elb/2012-06-01/paginators-1.json,sha256=7wrzQSPiNjefAUx04hXl_VclYmfODHBIuPNRGTQ_z1c,208 -botocore/data/elb/2012-06-01/service-2.json,sha256=8kBMn7TzlaHijXcgtBjnUK76mC1MTCRFgV3sniuyxtQ,97464 -botocore/data/transfer/2018-11-05/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/transfer/2018-11-05/service-2.json,sha256=MBT2hy6sJhUzZ0VKTGmwwqK2fsUnCq59QYRRY3IW4X8,50592 -botocore/data/datasync/2018-11-09/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/datasync/2018-11-09/service-2.json,sha256=wq2aJS9sfIGvwtahGjdZBrJB0H9f5PMrIZnKia3i_pM,66933 -botocore/data/datapipeline/2012-10-29/paginators-1.json,sha256=JdrA68aI3fnPWh2_ecOxC5DtcFz4OkiO8GvsBkzOgUw,554 -botocore/data/datapipeline/2012-10-29/service-2.json,sha256=CESWPLLdJnxvAQy_iuEaSGELUk4NhjptbJwBhKTheRc,76661 -botocore/data/serverlessrepo/2017-09-08/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/serverlessrepo/2017-09-08/service-2.json,sha256=l1__v7aGHpDfe1dQi1MiUSYxKfiucmUjHcy21GayWjk,106090 -botocore/data/mgh/2017-05-31/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/mgh/2017-05-31/service-2.json,sha256=wGjFifWRRI7qUEDimxyBbNoHNKlWdhCmbEym18Lwks4,46355 -botocore/data/kinesis-video-media/2017-09-30/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/kinesis-video-media/2017-09-30/service-2.json,sha256=PoTZ_1z-lPHnDzUenBzvnhJ1XenNvrZ3gf2nskkGgWo,11281 -botocore/data/devicefarm/2015-06-23/examples-1.json,sha256=7tNjHzbMOsFwnsYvrCTl8p1q6jrLEYGpyKDCqSGS6V4,42737 -botocore/data/devicefarm/2015-06-23/paginators-1.json,sha256=0Kkuc8V8ok8It861blVq2WTJfjI7qfqwkF1Yu2LvQzg,1889 -botocore/data/devicefarm/2015-06-23/service-2.json,sha256=w6sGChkMeJPWFPxZBVrRie3klRfyJpkJP-9GvrQA9BE,206292 -botocore/data/fsx/2018-03-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/fsx/2018-03-01/service-2.json,sha256=wgK8hy6qu0_PkFFIYKUomqDPaX33iWmni5i8sTOmu8E,70945 -botocore/data/glue/2017-03-31/paginators-1.json,sha256=asl29Z0ebzO7vYigoH_knzdkxgnFLcbleBZJWb9vg60,2189 -botocore/data/glue/2017-03-31/service-2.json,sha256=ZhvlDWMXK01IlNGS1Mhg-meLy0pFiIucOvROP9o68fw,243307 -botocore/data/machinelearning/2014-12-12/examples-1.json,sha256=mPd7boHY9w4xI-wG9j9rE088o-AWzYV37JIZ20tLApc,42 -botocore/data/machinelearning/2014-12-12/waiters-2.json,sha256=_tyML4Sw4VQBk8fUWh1bUQjlcooL1hgRpvkqxKxEeCY,1902 -botocore/data/machinelearning/2014-12-12/paginators-1.json,sha256=80ddAOlwUPt-mXpDtk3eJqnm7lB95-DjTW6-G6eqmJc,679 -botocore/data/machinelearning/2014-12-12/service-2.json,sha256=3HdUvkRMiM49ecS3Ovqc5L4wdBnWZR5IVNxjGVaY2-w,197474 -botocore/data/ssm/2014-11-06/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/ssm/2014-11-06/paginators-1.json,sha256=sI0pKPhjKLSUuHRd1zL6XgAU0B49t8gsjo01X_6GGbc,1592 -botocore/data/ssm/2014-11-06/service-2.json,sha256=nGLE4EzaLrFuItx-J9PfDQbtKIXhupdB8JiDogZH4a8,535211 -botocore/data/s3control/2018-08-20/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/s3control/2018-08-20/service-2.json,sha256=qLUVkgOEb0Pqex8sfXQLRnwF6H2i0pu_KpvzyT8TwpQ,8398 -botocore/data/macie/2017-12-19/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/macie/2017-12-19/service-2.json,sha256=LAkWzyz_S9eJ6Uv4jJL6mKgzNA62BTkzOeOLLUC0EE8,19612 -botocore/data/rekognition/2016-06-27/examples-1.json,sha256=zYPz5XICBaOAiJKhMEL556jfRws6tjNx4KjJAL5_97s,20342 -botocore/data/rekognition/2016-06-27/paginators-1.json,sha256=q7MuYMm5kzMdQLuBqh2vApI65VFN2IwDFbkhpYIqfGo,642 -botocore/data/rekognition/2016-06-27/service-2.json,sha256=5H5FeYUB0r22rqAJMP_h-jc25HXsyY5LrFtIoZsqjGY,179486 -botocore/data/secretsmanager/2017-10-17/service-2.sdk-extras.json,sha256=IEA3uxtjPY8I1on-q2W9-tozHHIVmneQyB6gCTcYTro,120 -botocore/data/secretsmanager/2017-10-17/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/secretsmanager/2017-10-17/service-2.json,sha256=eMO3OTEDAqhPHB9_pKny06SwMjBJ9YSCPX4eEnJV4nQ,123505 -botocore/data/cloudformation/2010-05-15/examples-1.json,sha256=gm_RqBO5j_WGR7ft7DnGJQokXca_j19gwyDlUFwrO3s,4308 -botocore/data/cloudformation/2010-05-15/waiters-2.json,sha256=7lsqeh7RU_Qgnbc330iYLIbOCx0extlTVmhAq3_Xw5U,4779 -botocore/data/cloudformation/2010-05-15/paginators-1.json,sha256=M9ZQ6UWYlgLUu1Up3TN4VDQlZNEaAlZv4YGx19ilkVI,829 -botocore/data/cloudformation/2010-05-15/service-2.json,sha256=QYCLRC2wUqpJKxDInpbC2n47lng4S_DrBtlNBoPzuAg,263469 -botocore/data/snowball/2016-06-30/examples-1.json,sha256=q_R4KbfIA1y7zg_AK1oGCFtOXeIgA21GGA_eBLKdFcU,18204 -botocore/data/snowball/2016-06-30/paginators-1.json,sha256=DDJjx7pnjIRcJOkB0hZDnFsWFhXv8oyIkI-LGRjm0sw,357 -botocore/data/snowball/2016-06-30/service-2.json,sha256=aNmoXYkiRxLrliOhxCEXOp1mssPIUCHv40VDopVTSxo,69764 -botocore/data/iot1click-devices/2018-05-14/service-2.json,sha256=2zIvoHp2lHaYlbEk6OiiZ43UPlhpuKyKPwgCf7UdJ9U,28041 -botocore/data/ce/2017-10-25/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/ce/2017-10-25/service-2.json,sha256=9cls4UxAoizWhA43r7iJnl1WybMhVF2bCUlE3HlF_7U,76907 -botocore/data/resource-groups/2017-11-27/paginators-1.json,sha256=-JHIduFu_Vod1GDUVnvUE5uThRCKqBBMLunoO4zu5xU,538 -botocore/data/resource-groups/2017-11-27/service-2.json,sha256=fPUN8Y38_NBlFHmnHL3eNwhG8bqzel4HhZelpWnEvEU,36108 -botocore/data/marketplacecommerceanalytics/2015-07-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/marketplacecommerceanalytics/2015-07-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/marketplacecommerceanalytics/2015-07-01/service-2.json,sha256=iYQabUsVEZke7AQE5uljqDDt4BvGJ0FRFo-LYV2WEhE,16150 -botocore/data/athena/2017-05-18/paginators-1.json,sha256=fwph2CRB_-FfFlWxU71jTdrlQ-_UriwVUCYYP1EsH2Y,645 -botocore/data/athena/2017-05-18/service-2.json,sha256=92P-afqnrfWRnR1AATblFjOltSi9x_nb-sFRiVevhyo,33904 -botocore/data/cognito-idp/2016-04-18/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cognito-idp/2016-04-18/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/cognito-idp/2016-04-18/service-2.json,sha256=fPVeFKOH_crKi_YZ_Fwq8MkN-iqBeBkr8DXc68Nr7O4,305955 -botocore/data/application-autoscaling/2016-02-06/examples-1.json,sha256=TRI_WZvx16j8jDh12FsT5mdlkUnI2-LOWBQk-qFVIOs,9536 -botocore/data/application-autoscaling/2016-02-06/paginators-1.json,sha256=rzEJ4K10L_HRDKijF9-VG7EKf1Nk_OmtWpWZmpDL2bM,569 -botocore/data/application-autoscaling/2016-02-06/service-2.json,sha256=kIxufzOghomG2Vsz28Th3UpGnMsLx-_3p4qlX8CHIfo,110627 -botocore/data/stepfunctions/2016-11-23/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/stepfunctions/2016-11-23/paginators-1.json,sha256=PNwTIZVCSCLLftzOmFPcc9ClpKUvGSRgHlGjKlUcqtg,696 -botocore/data/stepfunctions/2016-11-23/service-2.json,sha256=YappL7M8XN1uNXN3VDcpfabBBQcCK5ci6qvkZ2JL-W0,73712 -botocore/data/es/2015-01-01/paginators-1.json,sha256=4P7bTXG-4BwfbtgFq_4HjB8uIneuXnG8b0G280iEEQ0,411 -botocore/data/es/2015-01-01/service-2.json,sha256=2UJCW5Li3AR-RI2Nk_rqM4VPxKGSOrZAb14Gn8mrto8,104041 -botocore/data/importexport/2010-06-01/paginators-1.json,sha256=Etmobek-KI_4Gx8vLRBQsy6nYiRvog88hJCCXuRESZQ,215 -botocore/data/importexport/2010-06-01/service-2.json,sha256=YhhOo0SgwD5k5DsgpPmW9SGOZYkiTnwx_T11WYNGcPo,33582 -botocore/data/ds/2015-04-16/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/ds/2015-04-16/paginators-1.json,sha256=sQqB6XGYfdAXXzyfVU6ObQojfhMQySNFAjY26DvbtuY,204 -botocore/data/ds/2015-04-16/service-2.json,sha256=B6sC0deRKrDUPvJ_83vE2tKTsycuk7semrxZIoGdawU,145238 -botocore/data/kinesisanalyticsv2/2018-05-23/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/kinesisanalyticsv2/2018-05-23/service-2.json,sha256=xJEgH_XqEMSsUwZ7oTTF6rZJpzZtcQ50UEVp1fUvpR8,140034 -botocore/data/kafka/2018-11-14/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/kafka/2018-11-14/service-2.json,sha256=owocAqOyuBSRUrN1yV2gK7gY_1R-Gz_A4q9TDvqRoA4,34540 -botocore/data/rds/2014-09-01/waiters-2.json,sha256=9BpCCotIHKKeyJHD5Bo1fdRi6EnHK6jyJJx_9wswzCQ,2645 -botocore/data/rds/2014-09-01/paginators-1.json,sha256=CKMhQjYqNQB1hiHNi4vCNIVtQvu29SM_ySRhqxTKfOQ,3095 -botocore/data/rds/2014-09-01/service-2.json,sha256=wNNc81NVVzYUums08_BY4x2WYi7w7CggTAXPZkQuQmU,326067 -botocore/data/rds/2014-10-31/service-2.sdk-extras.json,sha256=M7CXc4xhcbZw9nhShvKNkQH_YQF477PslBBT0cweG5Y,1068 -botocore/data/rds/2014-10-31/examples-1.json,sha256=ilej1HldMOww25u8JCAlutyE5CQiRuTlGyFnia3nlBk,48986 -botocore/data/rds/2014-10-31/waiters-2.json,sha256=lBWB4MDYhDFIb9Ley_xjR36dkUn8z4Kkxa2CxCz2EO0,5085 -botocore/data/rds/2014-10-31/paginators-1.json,sha256=Zd-1SzR2SwAT1ZLvbAbzuEs4YClRd7h0taNOLJS0xxA,3807 -botocore/data/rds/2014-10-31/service-2.json,sha256=HbZitLFi4-DKandI2NGfqm5_KLKVXdTGYe_mdcfwsN0,593892 -botocore/data/appstream/2016-12-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/appstream/2016-12-01/waiters-2.json,sha256=3vm18B_pbfSz_IE9ckMWSSC0e9xCiPY1tYigPfqrsS8,1263 -botocore/data/appstream/2016-12-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/appstream/2016-12-01/service-2.json,sha256=R2DwqjFr1vqFqIdG8h2Ea1DBxzdxQ9TnSrC0jjNlW8g,112744 -botocore/data/kinesisvideo/2017-09-30/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/kinesisvideo/2017-09-30/service-2.json,sha256=ClAT95r71ydg-3xdcvtKsuSkwRKJjEhtoYAIuZpDjwU,30971 -botocore/data/translate/2017-07-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/translate/2017-07-01/service-2.json,sha256=Kcd5_q7JaP8PbAhUAXRIfW8p4W3Grbsj7ZRsvqAHSdQ,22485 -botocore/data/appmesh/2018-10-01/paginators-1.json,sha256=-TPoHMW78DG37BJz5SNi67CsUIs4PTTccyUhlXtMBm4,665 -botocore/data/appmesh/2018-10-01/service-2.json,sha256=o2b7WjVHx-mWUQvbXOMaZt4Aq3Fsnn9x65hYT9aIfu8,73232 -botocore/data/inspector/2016-02-16/examples-1.json,sha256=ehjV-XneKYe27HyYHvghjdFy5x1dW_wgr0-aTug5GHE,36664 -botocore/data/inspector/2016-02-16/paginators-1.json,sha256=tCsN1wyolCPCaVvz-FSR_VXx9VQG77RYDhq2X9hW0oU,1441 -botocore/data/inspector/2016-02-16/service-2.json,sha256=cbG9h9wxPKkXS7g3UjxDrDNoYiJQO7C3LtdYFucg-Us,126030 -botocore/data/inspector/2015-08-18/service-2.json,sha256=uHo82k_AcZJR4OdAQc0lu87wzTr682bOjTTt1zWZ22o,81021 -botocore/data/health/2016-08-04/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/health/2016-08-04/paginators-1.json,sha256=OGFmv_q5cV_Z4YEF5ne63h7G9xrRtKn7Vs4CoFDkxDc,711 -botocore/data/health/2016-08-04/service-2.json,sha256=DxqJpC5MjPG7iPfg5n1N82fqL0d-IFcJp3XhMZXxtT8,36161 -botocore/data/cognito-identity/2014-06-30/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cognito-identity/2014-06-30/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/cognito-identity/2014-06-30/service-2.json,sha256=FG0M9LInhcAoh8Axkj1aFeJgO6ZXD6Ua8mCOJ3mvJiQ,57054 -botocore/data/securityhub/2018-10-26/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/securityhub/2018-10-26/service-2.json,sha256=IwHNCTpiH_q4u60LAwTlDjHHEnl2SBk7v6MCjqX3DQQ,94384 -botocore/data/mediapackage/2017-10-12/paginators-1.json,sha256=tcRHlN_xMKpNkCW0-B3wKrY4f9xo5EcoAPgINjhKcRw,363 -botocore/data/mediapackage/2017-10-12/service-2.json,sha256=VpIm1JIFXqbNI3fafDQt0QIvwnEdBnH3Sh2Xg46fUvg,68226 -botocore/data/budgets/2016-10-20/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/budgets/2016-10-20/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/budgets/2016-10-20/service-2.json,sha256=qiKJs79nnXLwD1S963jjlydP9PkwnSYsbVeHCU1hRPA,48987 -botocore/data/sms-voice/2018-09-05/service-2.json,sha256=TtBJja8wEmWu5LRzBWOMTBRMnOvprTmdyWbgeA9Aa08,23590 -botocore/data/servicediscovery/2017-03-14/paginators-1.json,sha256=sKu-j-WBHT8KpiemY4vgLiQkV1Ub2GtqLbYiUxdkjjE,683 -botocore/data/servicediscovery/2017-03-14/service-2.json,sha256=NshcX5wL4wytGS0fvaLXiBJaXfiEg9Fkqd9f8j34bkM,102021 -botocore/data/elasticache/2015-02-02/waiters-2.json,sha256=N6NTYHqUoktWaIjapl3RDepPknxNlIbb8a0wnS0HB_E,5118 -botocore/data/elasticache/2015-02-02/paginators-1.json,sha256=YkZxwpICpidoDrIimyr0yFGYg_T0emkSfhlNfPOfVMA,2171 -botocore/data/elasticache/2015-02-02/service-2.json,sha256=DumCTzoxJsMQTgs94HhOwPrCGNkQVJohxEYJuDcHbRw,254584 -botocore/data/elasticache/2014-09-30/waiters-2.json,sha256=mIVMN9SNrvDJ2iW_uXAA-N5ptxGmDw964Sv89zKAs-g,3719 -botocore/data/elasticache/2014-09-30/paginators-1.json,sha256=YkZxwpICpidoDrIimyr0yFGYg_T0emkSfhlNfPOfVMA,2171 -botocore/data/elasticache/2014-09-30/service-2.json,sha256=g4xh0vIu6yGt3ilzFkPVilbQJQKiJhCrvnUn3gJbyQ0,223047 -botocore/data/redshift/2012-12-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/redshift/2012-12-01/waiters-2.json,sha256=mvax_COD6X10xa7Toxa2DsrarFdKFg9kOWbIKRLahS4,2344 -botocore/data/redshift/2012-12-01/paginators-1.json,sha256=NMPKwQZVsNECCmA9ie84kbQFCjaEhlBH-AKs6qZBMPE,2726 -botocore/data/redshift/2012-12-01/service-2.json,sha256=zuntpVGioXJ2j0ipLsEG0uoJOpESdIbp-kXdSOUJZoU,365923 -botocore/data/codedeploy/2014-10-06/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/codedeploy/2014-10-06/waiters-2.json,sha256=OARBxBeZTRUui1WztkVtUn7Q2lAh3-Bemczgk455MGQ,662 -botocore/data/codedeploy/2014-10-06/paginators-1.json,sha256=6EF7gMw57yGDIEOmmCYUDpu6CRyXyaK97qO63pVqYLs,880 -botocore/data/codedeploy/2014-10-06/service-2.json,sha256=D_wOGWi_zWjFq4O3o4F2_CkjITuOLOhvbUNzv2kIqF8,195206 -botocore/data/cloudwatch/2010-08-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cloudwatch/2010-08-01/waiters-2.json,sha256=6n80zThNd1Ep44E55Vs_oXDX2f69PXcIFrudKwhzStQ,335 -botocore/data/cloudwatch/2010-08-01/paginators-1.json,sha256=DGrUSVUTcc3N1sR37kMgt179hG1Zu-B6RXgnfbDEQV8,638 -botocore/data/cloudwatch/2010-08-01/service-2.json,sha256=9SE4uZBQNlXC1C-wYpp_uhTGAHl7_Qju6a9Nf1zafhk,91279 -botocore/data/license-manager/2018-08-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/license-manager/2018-08-01/service-2.json,sha256=d7LQhlcMu453nWtcS_H1TD1C5ujix_zA5mmZBbH4ed0,42424 -botocore/data/kinesis/2013-12-02/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/kinesis/2013-12-02/waiters-2.json,sha256=O09l7u4uKnojQ0nCnGvABSm0pUXaLj8vvi2Y7sfH_9w,615 -botocore/data/kinesis/2013-12-02/paginators-1.json,sha256=0V9ZORq8OT1SD03-0kH3BmDzKjJKkZtJSNcInl0WglU,905 -botocore/data/kinesis/2013-12-02/service-2.json,sha256=Qm4Mys9Bh763rWdCZPxTbwYlR1pyQzVMrB8BMkD4SbQ,122646 -botocore/data/elbv2/2015-12-01/examples-1.json,sha256=4Qxoz28hEDW8u1O7iGLKnH9NNb7Po5qybLFQtvtR7ss,44281 -botocore/data/elbv2/2015-12-01/waiters-2.json,sha256=k-g2ypXqfbW4ktwuK1iVKpApIncFhOPemhbs7pf7cW8,2371 -botocore/data/elbv2/2015-12-01/paginators-1.json,sha256=csFZQ6XPGcg9yTfhnxieLdZPCGMO93qEH7sFrjS8Mxs,531 -botocore/data/elbv2/2015-12-01/service-2.json,sha256=4XN5KU48Iq7l0OFCuN6x-rAhRejtE2AfJQL0UbiDbJs,136745 -botocore/data/appsync/2017-07-25/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/appsync/2017-07-25/service-2.json,sha256=XH08Fwsc1fRM6pSOpCl0v6_lXyMZKSYyZ8kobfr5LB8,81490 -botocore/data/elasticbeanstalk/2010-12-01/examples-1.json,sha256=EuEpZEobhGxWPfRosGTFNWYs8zRFVtkQtLXD8M_5fm0,37449 -botocore/data/elasticbeanstalk/2010-12-01/paginators-1.json,sha256=l8BG04gvfO_Ss7mElLCb6ASGmtEVxmeJlqdr6gIjAb8,187 -botocore/data/elasticbeanstalk/2010-12-01/service-2.json,sha256=yvt1-W0VbWv3HDI2JgBJOWI7urMAwOlOTeUvAM3j8R4,176009 -botocore/data/resourcegroupstaggingapi/2017-01-26/paginators-1.json,sha256=fJ_fldVkGj_VYI6cC1Ny5nji6QzufaUA4UyELkgbG_w,499 -botocore/data/resourcegroupstaggingapi/2017-01-26/service-2.json,sha256=WvsGxwNmJOZ5--A7EFGOI4cZjLaKat0fBqNnrGF4aeA,22713 -botocore/data/acm-pca/2017-08-22/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/acm-pca/2017-08-22/service-2.json,sha256=eZr9yoD6iEqr6CQRf1dLEhMWOEEiYGi-b1bwkyRFvaM,65381 -botocore/data/cur/2017-01-06/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cur/2017-01-06/paginators-1.json,sha256=svrnnDA-WDB_TSjNDhx_3bXmieM10GBn4TRFNlZNPHg,209 -botocore/data/cur/2017-01-06/service-2.json,sha256=X_t8935NYqc4vmeKKvRzFSYsTHkwYF4NZ6ocaArVWac,8149 -botocore/data/globalaccelerator/2018-08-08/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/globalaccelerator/2018-08-08/service-2.json,sha256=IOIQMV6w9crei7nyIxWg4V9kdQVSOaYzK9o0knexggk,50597 -botocore/data/directconnect/2012-10-25/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/directconnect/2012-10-25/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/directconnect/2012-10-25/service-2.json,sha256=0usk2JigoXKEq3z8k67qX67O-qHMwy9NJcp98wvR93Y,113187 -botocore/data/rds-data/2018-08-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/rds-data/2018-08-01/service-2.json,sha256=GT2ouktsY8tyoBTsyn6Ejr4qV_SKnQFk3o4nuDj371g,11631 -botocore/data/lex-runtime/2016-11-28/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/lex-runtime/2016-11-28/service-2.json,sha256=wucazBRI3DZjpaXP857rJ1mOEVvkmEDz-qyCALwR_MY,38841 -botocore/data/sagemaker/2017-07-24/waiters-2.json,sha256=jaRP-zks6vx3_oCHpY0NurRnydxftyZh1083Pvtmfhc,3955 -botocore/data/sagemaker/2017-07-24/paginators-1.json,sha256=Wk9sE00rFQ0TWahE_-IC7UI0JSq3LI67Q7kPt2lKq8M,1035 -botocore/data/sagemaker/2017-07-24/service-2.json,sha256=iZNzdp58V4PLFdWrtl6WObrGErMiL5KyJJmknJfmM6I,389561 -botocore/data/dynamodb/2012-08-10/examples-1.json,sha256=-EGbj_SVvhpxH7Qv3Z70wx1D1CtI-xfaXJ618Ee3rLM,16882 -botocore/data/dynamodb/2012-08-10/waiters-2.json,sha256=G_iaXR3xZP3M8lpMR1olm2p-EvK6InTidNZnUUqPL70,727 -botocore/data/dynamodb/2012-08-10/paginators-1.json,sha256=v4n4RgaTvTMVKvP69bZnKUQXzH65NGuZCl-4tur38Vc,972 -botocore/data/dynamodb/2012-08-10/service-2.json,sha256=8aWU7v5KL1CwTE-L6OeZ4rKKHEaOLXCmB73oqkndkvk,335838 -botocore/data/route53domains/2014-05-15/paginators-1.json,sha256=HDmOOE0bHHtB4A6XI9rsnMT2bWNz7MB3Le1ivFme-os,371 -botocore/data/route53domains/2014-05-15/service-2.json,sha256=UE72DrOxu8shxPN7CnPaHk7mn8AVwkCrdS8AGApELqo,84520 -botocore/data/comprehend/2017-11-27/paginators-1.json,sha256=_abmL8V94atLcPgfTCAdLaPRsNEhb6OAeaVYAuFNrj0,222 -botocore/data/comprehend/2017-11-27/service-2.json,sha256=AqwgWW2bU1vg6ClUCToffdz7yOpKpuMX14jJQcg8baM,137261 -botocore/data/apigateway/2015-07-09/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/apigateway/2015-07-09/paginators-1.json,sha256=A1YjgRkhmZFhFaW-xgAapa9E8zLUWjc4L58E0edVzRM,1863 -botocore/data/apigateway/2015-07-09/service-2.json,sha256=8EaBm3qdT3SxTLureTUfGtaFEr52xaLzio8Js6knF10,357810 -botocore/data/signer/2017-08-25/waiters-2.json,sha256=ZvZgSYJd2QhWkeR1jaM1ECQ8295slZ6oDEFLtA2tYRE,607 -botocore/data/signer/2017-08-25/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/signer/2017-08-25/service-2.json,sha256=iArBRvaI0YXwWpb5AHkqR-7apKf9sYtzXFGrkG8o9YE,37646 -botocore/data/transcribe/2017-10-26/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/transcribe/2017-10-26/service-2.json,sha256=8qF40fPH23hbkIoqkv5XJKPauDL-5Rx2s4nKBrdyoEk,31867 -botocore/data/pinpoint-email/2018-07-26/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/pinpoint-email/2018-07-26/service-2.json,sha256=JhgAqoof4FFQ5VEH86K7NbDgvlTVLdqMVwgICP8JK0E,104986 -botocore/data/workdocs/2016-05-01/paginators-1.json,sha256=xh7IMkAvTKXxLdzdkioaeSdEg3GWHYsZ4TRv4rV8Rtw,544 -botocore/data/workdocs/2016-05-01/service-2.json,sha256=e3DtnkOGbx6U-60mGv7p59XG0lNKbc9p2NsBlElscuQ,130037 -botocore/data/pricing/2017-10-15/paginators-1.json,sha256=CaVVre83L_F8FNTp9no-9EIRlqx5kxNSPU_U2zoSqNw,622 -botocore/data/pricing/2017-10-15/service-2.json,sha256=C-2ZVZ_jCehOLwoCQdqWAi9opd17RVDP6KiYlZ0-kNc,13861 -botocore/data/dms/2016-01-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/dms/2016-01-01/waiters-2.json,sha256=vfLeUiOkuOYHtitArhH_kRZbM6uL4N58GER0aRz7btc,11982 -botocore/data/dms/2016-01-01/paginators-1.json,sha256=Y3SZaT-h8ftXIrqxEa-ITfC6Bin1V9vBGh6xMm3zXXQ,2332 -botocore/data/dms/2016-01-01/service-2.json,sha256=y943hjSUhF2-zlPeRHaEF2cw5cnIvgFoQAlwa-Hlqsc,156594 -botocore/data/lex-models/2017-04-19/paginators-1.json,sha256=NmghgFUthvQgC3SqXuZBn-6vnUJ5ey3MZYBpRF7YMqI,1686 -botocore/data/lex-models/2017-04-19/service-2.json,sha256=M4vDRQh0QMEp4cCvoJLr7EclCAQbMWs3AWpP-M0bGrk,157045 -botocore/data/config/2014-11-12/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/config/2014-11-12/paginators-1.json,sha256=H3dpxQajMsVlwJQdDP5KR6BiCzj58X8c9iXGGXnS5LI,1128 -botocore/data/config/2014-11-12/service-2.json,sha256=HQHWiLtBLNazp70azDRJl9QBG3Hz2hWLlehev4HAX48,180820 -botocore/data/pinpoint/2016-12-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/pinpoint/2016-12-01/service-2.json,sha256=FCYOAZcBkX6uX3p_yYdl9FiF2VGD22_xIY8jgMFU3Ww,300193 -botocore/data/batch/2016-08-10/examples-1.json,sha256=dP4kuMX_71qsShkh4dIYR5uzLVCtvnWQS-tsz6SOsNE,17063 -botocore/data/batch/2016-08-10/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/batch/2016-08-10/service-2.json,sha256=CIK-6VL76ABp3KIk7KcVq_L4kZsKA5aA6BnavWTfE4g,96530 -botocore/data/mediaconnect/2018-11-14/paginators-1.json,sha256=nUNgSEyNYVd1GIeXJJGybj3tO_AwN-_I9gppjHyBnlk,181 -botocore/data/mediaconnect/2018-11-14/service-2.json,sha256=dPeLlYF0gbitP_zfHOwn1ncnkqViVsi-2_f0VAJD9wY,70571 -botocore/data/autoscaling/2011-01-01/examples-1.json,sha256=KudYU6YobSVgFHfvRKDDVdqxkamvzVhv3WGkadkKbF8,43442 -botocore/data/autoscaling/2011-01-01/paginators-1.json,sha256=so58GPDqpI3ssBiKQPmP5qFb5ptRpvNGB9QMLx3ltNA,1492 -botocore/data/autoscaling/2011-01-01/service-2.json,sha256=lqE-UpCpUOqBfwEnjTBYsE45dp6Mg4_rh3Cw9o9TCUA,186804 -botocore/data/marketplace-entitlement/2017-01-11/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/marketplace-entitlement/2017-01-11/service-2.json,sha256=g0FbtVpxwUVfYxNCgrXidNa4z6zI2SVRVajusOVJiCY,8526 -botocore/data/eks/2017-11-01/service-2.sdk-extras.json,sha256=pmn0V8Su5NiqW8Y3X-IBtzD1Bz_JANtKgU4fsr-i_bM,107 -botocore/data/eks/2017-11-01/waiters-2.json,sha256=RlOHONt8jx7YBsW4Mp1-PK5fUOmRf77htyQIqiyhJOg,1209 -botocore/data/eks/2017-11-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/eks/2017-11-01/service-2.json,sha256=zbVE0laCgo7G7cFw30Sqq36tginKQJeKFln11Ne7UDM,20400 -botocore/data/chime/2018-05-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/chime/2018-05-01/service-2.json,sha256=CgOQUGYhW5oqoUzg-b77ohGZ1fS2QnxMOUxaGfA4H28,42224 -botocore/data/polly/2016-06-10/examples-1.json,sha256=-uFGLZQ6nTWN0cCt3DVe5TWPh8TbmBGwBTOpcW1Uq00,5102 -botocore/data/polly/2016-06-10/paginators-1.json,sha256=H2Ug-35GRTVHRRu1PMQBVhOJanu-5i4goJPnZudmqpY,154 -botocore/data/polly/2016-06-10/service-2.json,sha256=ky2yQBFJbM_uIjgCPv-iYQswGS8-FlOJjBFBuvV7TFU,42725 -botocore/data/route53/2013-04-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/route53/2013-04-01/waiters-2.json,sha256=s6BzW8AQ9pEM5yCsRa64E7lfUvhX5vxNARuiAtZwjsU,338 -botocore/data/route53/2013-04-01/paginators-1.json,sha256=muX2py7oddcqGYYWwkt1kI_taDh2qimXIyBCZHlmHVA,811 -botocore/data/route53/2013-04-01/service-2.json,sha256=ZgTJ7Ub1u3biqbfBIAkj5UzQMVmlJ41-i-A1S66Y16E,334977 -botocore/data/amplify/2017-07-25/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/amplify/2017-07-25/service-2.json,sha256=UiJ9wQPigjM7z_-ttRyBWICCNwqjCFMbSdgsPTVE5CE,61357 -botocore/data/iotanalytics/2017-11-27/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/iotanalytics/2017-11-27/service-2.json,sha256=kOIbmaUvuUv_HIVW1qRhPQ_gq-i0b8MnIXDubs2hx5I,96214 -botocore/data/organizations/2016-11-28/paginators-1.json,sha256=62ShD80Q2LtfchtJjMgsXqTnN9BagRKnBBQs9kAmjIk,2275 -botocore/data/organizations/2016-11-28/service-2.json,sha256=r78quTI1wecfKm4j_kRrkiN0rOyUhX62fEbKpnQkZSQ,191042 -botocore/data/mediaconvert/2017-08-29/paginators-1.json,sha256=XtVkBZdug_R7jlAQkwBNEbs8cZKzZA244SKTQ7hFaxA,835 -botocore/data/mediaconvert/2017-08-29/service-2.json,sha256=U-hGv8l75r9DdqjT6dQen4u-jNwJwTX5cOxlypHAxeY,358478 -botocore/data/codestar/2017-04-19/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/codestar/2017-04-19/service-2.json,sha256=ENniYvtGiDRcQyK8hpXtf_qG0luuNjgoOMXX4mHgvzs,55261 -botocore/data/swf/2012-01-25/paginators-1.json,sha256=tOiP-8y-iuvOSJM35cQg6qCE0ai5dd5IWenCE1BH_yk,1496 -botocore/data/swf/2012-01-25/service-2.json,sha256=J_ucgRd9cZXu7WavWkrHDqwdWCHyM-3fTI2UzhheTLU,326446 -botocore/data/guardduty/2017-11-28/paginators-1.json,sha256=Cfivxqo6J9vs1uCcQW9WnW7TkWoR-lIZbmU64zp7hzg,1185 -botocore/data/guardduty/2017-11-28/service-2.json,sha256=3BuRKDWjKhjoi3es2Hh2blX7WwE0MYJ-RpcCTW5pqyQ,123211 -botocore/data/ses/2010-12-01/examples-1.json,sha256=BPPSz90N_FdJKUCWXbAaaHDmBHUlTv3HHiudDbBAV2A,26812 -botocore/data/ses/2010-12-01/waiters-2.json,sha256=4GF4zY3Tg43WiGAVWSJeabII8bSEU7_ElsMj_G3Bt68,380 -botocore/data/ses/2010-12-01/paginators-1.json,sha256=yJZrYSBuHt0KS4SRWbTEbPEoFVM6aNHklCGtTRUa64w,399 -botocore/data/ses/2010-12-01/service-2.json,sha256=XAMoT5DmTQ2NziFoE7cW7BDAcb1mbbhaGC1AnD9KfVI,262583 -botocore/data/ecs/2014-11-13/examples-1.json,sha256=Os-F9xud11tWbiSWvbMYs3Ol-Rw2gv4jNDC3BaWvp5c,27987 -botocore/data/ecs/2014-11-13/waiters-2.json,sha256=F4d_a7_xVQIib5MpmSitTQBxupfL0Z9NqxOibIA6Igs,2246 -botocore/data/ecs/2014-11-13/paginators-1.json,sha256=rPbFiXvcaiW-FcoskZTatk8mXVKwLl-OhQ-XmDH6oLo,1054 -botocore/data/ecs/2014-11-13/service-2.json,sha256=7Mrgz4KYXpUfJmUPSBGRGUQMVVV_EUNHl6liQ6TFJkk,299743 -botocore/data/route53resolver/2018-04-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/route53resolver/2018-04-01/service-2.json,sha256=YIessklIYCu2hdP2WYVundgSStpChkmk7xq_Vy84rxc,67682 -botocore/data/s3/2006-03-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/s3/2006-03-01/waiters-2.json,sha256=m0RJIxnJW7u6emLjY1201rmfeKxgz1f7VDU7qKJOI4c,1436 -botocore/data/s3/2006-03-01/paginators-1.json,sha256=w9y0i0AX9O0ekVoSr9YGPc-NmebCH6eSMLPoTN4hbBU,1567 -botocore/data/s3/2006-03-01/service-2.json,sha256=Ijhs7z47MALJ2KYxZnXl6lybJ0kTCsa__dgu2cJ6g8I,296252 -botocore/data/sdb/2009-04-15/paginators-1.json,sha256=3KF7ZF879CPbTIZ8drlqnq5S3aFHdubXunwekE3ARG4,317 -botocore/data/sdb/2009-04-15/service-2.json,sha256=unrwOjr6Fv_CN9tPYucNhv5QpfFviMT77F7_HPP4prk,44405 -botocore/data/meteringmarketplace/2016-01-14/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/meteringmarketplace/2016-01-14/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/meteringmarketplace/2016-01-14/service-2.json,sha256=A03yutjxaJszeCJukJN79lwJZGFy-iLENMF5BVnX8X4,22271 -botocore/data/iot/2015-05-28/examples-1.json,sha256=mPd7boHY9w4xI-wG9j9rE088o-AWzYV37JIZ20tLApc,42 -botocore/data/iot/2015-05-28/paginators-1.json,sha256=5RHboEQhd-AzeuzQVs7HyDXwdrCNnj4ZjfDqDwAFHoI,1856 -botocore/data/iot/2015-05-28/service-2.json,sha256=sE-1avjoLGwmEg8pdJsU3P0KfVHl0ppyK3YKO46pgd8,437808 -botocore/data/acm/2015-12-08/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/acm/2015-12-08/waiters-2.json,sha256=S3uw0vWaMVDBNCST96n0BIyzhiBFuX0Oqp9C-SCxYeE,874 -botocore/data/acm/2015-12-08/paginators-1.json,sha256=oB2exj3JKzcsLCvfBeMqYawlxz6YghtvUQlwOfdTY4g,203 -botocore/data/acm/2015-12-08/service-2.json,sha256=WQs7LLMSM3JWMk4W33gaTvTAZWJacJwVsXWwr_FqQhI,57976 -botocore/data/clouddirectory/2016-05-10/paginators-1.json,sha256=y8GPuHURJmdagJ3QAI5mxkAzKvdCZwcnfYt3Z-qwgAU,2808 -botocore/data/clouddirectory/2016-05-10/service-2.json,sha256=ZIjBC0fe-l7RWhxmAwTASKo8OqPSPee1GGsH5Go42Hc,229185 -botocore/data/clouddirectory/2017-01-11/paginators-1.json,sha256=y8GPuHURJmdagJ3QAI5mxkAzKvdCZwcnfYt3Z-qwgAU,2808 -botocore/data/clouddirectory/2017-01-11/service-2.json,sha256=ZN0o_vklfZQcZ_xz0D3Vxz-Ata_kY8WspdVvPhswhPI,235220 -botocore/data/cognito-sync/2014-06-30/service-2.json,sha256=hkPOHyw-EH4KNHt7aZHMgmJ0gSLr7WiClKS9yNWhIJ4,87989 -botocore/data/opsworks/2013-02-18/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/opsworks/2013-02-18/waiters-2.json,sha256=2crmFuAdFm1n1gXfrbBHg_w-b0aaCPtBiXxHzp1N-LI,7578 -botocore/data/opsworks/2013-02-18/paginators-1.json,sha256=Z7xh6Z3rU23wP3DvH7dA_6rESCx1av8E7ABInwpMRY4,197 -botocore/data/opsworks/2013-02-18/service-2.json,sha256=rDqsIvBjvhZJLOtuvw52g36RUkrak2BDwu1gJd1JBIU,270555 -botocore/data/glacier/2012-06-01/examples-1.json,sha256=hR-1NmWo9lL0Cdqnr6x95Ywu_VfJucv0T4OveUp-S4o,27536 -botocore/data/glacier/2012-06-01/waiters-2.json,sha256=hzoyJJT1wJh9lq1_z4MK2ZBj98TGRhroii0kbeFXnJw,785 -botocore/data/glacier/2012-06-01/paginators-1.json,sha256=RAeqGFOs4GRiC-DuphMOBHWljwDfqBQINYf1qA2LbNA,628 -botocore/data/glacier/2012-06-01/service-2.json,sha256=1wHvtHU0EHdIdu8i6huMNTR2_Myt2TYlpIbkpIehQ5Q,154882 -botocore/data/storagegateway/2013-06-30/examples-1.json,sha256=2-mBPJqbSFv2f3t6KqdtrU5dW0Z49zylBvFGmoQEAk8,49947 -botocore/data/storagegateway/2013-06-30/paginators-1.json,sha256=k9kh5uNaprYcnSFFI6mo_0sde2cU6dcAv5oZwz93ZwU,979 -botocore/data/storagegateway/2013-06-30/service-2.json,sha256=Y8MvjLvYw5Mn97YE02fJiOWUT6IAYcpSLpWorc2QpWU,198510 -botocore/data/sns/2010-03-31/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/sns/2010-03-31/paginators-1.json,sha256=vSctAMM5ppPnwzzVJVWNOyyYcsLrUqZ5WiwJxtCGOGE,740 -botocore/data/sns/2010-03-31/service-2.json,sha256=MlqRCpJEzbcvwK4heDvLYpiNcPqm-6Bj2cUAPuqgiFo,88934 -botocore/data/support/2013-04-15/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/support/2013-04-15/paginators-1.json,sha256=b74jGAMdiNu8tKXAfyVILd2DpHqQx91qieo1BlSXpK8,363 -botocore/data/support/2013-04-15/service-2.json,sha256=lxpfVOKL9kIg85J2d-pHjExu2C7NzY5OMS-5Jb3ek0M,61270 -botocore/data/ecr/2015-09-21/examples-1.json,sha256=meQrqvxr4X0t9tOcJ0Q1W207GRKYkaRZ_P1irgzZub8,7212 -botocore/data/ecr/2015-09-21/paginators-1.json,sha256=09fbL8npDH2tkUnVlR_krjCnuElCHYpYG9w5UMHv1ss,527 -botocore/data/ecr/2015-09-21/service-2.json,sha256=RY5JD0-FUj08k3o5f9SsBjRJ8uP8cDF7DpKL8Yh8IGU,75159 -botocore/data/gamelift/2015-10-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/gamelift/2015-10-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/gamelift/2015-10-01/service-2.json,sha256=7b3GTR7d-ZxhwwXJqlu8iXG1EEVjkYQjP_1tCM97AW0,364991 -botocore/data/cloudsearch/2013-01-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/cloudsearch/2013-01-01/service-2.json,sha256=koLZGTodYP8TD1LUNw8etH7_a3Q7vTU-BsAcH32_n6k,124093 -botocore/data/cloudsearch/2011-02-01/service-2.json,sha256=kj2flFc1nvY1esVU0Nfogz6XKNbPPWDPjfdYFb6a6xs,84791 -botocore/data/kinesisanalytics/2015-08-14/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/kinesisanalytics/2015-08-14/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/kinesisanalytics/2015-08-14/service-2.json,sha256=TJnYELLF-s-WRJoTb49sLYb_GOdy7tJThwF7EaHwcdk,102346 -botocore/data/mediastore-data/2017-09-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/mediastore-data/2017-09-01/service-2.json,sha256=ZEIJQ0Xk076CvI4lz1Gkw9hmj3EfVh0Um7-3z7YgNRM,19441 -botocore/data/cloudtrail/2013-11-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cloudtrail/2013-11-01/paginators-1.json,sha256=vjy4dmJ9EPeZb_mMxg-xPiGwRl5z5wqyDevbF5GBezA,185 -botocore/data/cloudtrail/2013-11-01/service-2.json,sha256=VlC1rzBBJdYVMgyCE33upBfVUF3x5YXliW-wDz56Ir0,84547 -botocore/data/autoscaling-plans/2018-01-06/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/autoscaling-plans/2018-01-06/service-2.json,sha256=_w3LyQ2EKrEwzO-r4eirQUUj8QvoieQX6N7d4taVbqY,49976 -botocore/data/neptune/2014-10-31/service-2.sdk-extras.json,sha256=U_PgxwtPhWl8ZwLlxYiXD4ZQ4iy605x4miYT38nMvnM,561 -botocore/data/neptune/2014-10-31/waiters-2.json,sha256=8bYoMOMz2Tb0aGdtlPhvlMel075q1n7BRnCpQ-Bcc1c,2398 -botocore/data/neptune/2014-10-31/paginators-1.json,sha256=4fCz1pDCPWb25EV7Q_UuMSTit8ZtExt-BbIlxOaUHz8,1626 -botocore/data/neptune/2014-10-31/service-2.json,sha256=3rwzZ1CqI9TQ2VtnhNXem8l-jX5zJe4mPkXHy3vK2fc,285234 -botocore/data/opsworkscm/2016-11-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/opsworkscm/2016-11-01/waiters-2.json,sha256=nTnFtemD7H4YJ99PqmULXNfZeNb18T1sxitQXDntJ2o,582 -botocore/data/opsworkscm/2016-11-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/opsworkscm/2016-11-01/service-2.json,sha256=-snckmHkXufRaiXp4TJ41tivW_wIsGZ5bRpIMfVC5Hs,64404 -botocore/data/sms/2016-10-24/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/sms/2016-10-24/paginators-1.json,sha256=Sa2jXtZ8joTXyWL-PDxNESwqr7hAMtuUa28LXTGciOQ,711 -botocore/data/sms/2016-10-24/service-2.json,sha256=aVSGOv6RZkpvNtQjbyXCd8AcplFpfsLl92IO7-if9r8,70640 -botocore/data/mq/2017-11-27/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/mq/2017-11-27/service-2.json,sha256=68Dm9DQ7VJtDb7jnQqXlMTKwG6U0lkbGbGEebf6Luc8,110676 -botocore/data/dynamodbstreams/2012-08-10/examples-1.json,sha256=LF2m4pmyTs0G8NR6AhmybL0E2F9WHfnbxz5q31DtjAg,7693 -botocore/data/dynamodbstreams/2012-08-10/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/dynamodbstreams/2012-08-10/service-2.json,sha256=iXTa0hLwT2P2jz7mIveHlArJKHEkoNcnFYEmDKv59HI,30490 -botocore/data/pi/2018-02-27/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/pi/2018-02-27/service-2.json,sha256=GkDaU9ObFVgoQDh1UPRTnFHBg1atX6eJ9ubfXd4vClk,23067 -botocore/data/mturk/2017-01-17/paginators-1.json,sha256=NFfGwUHHAX0lwKOB92RJHnfVkFP5IvDCtM1FnTJ-A0g,1591 -botocore/data/mturk/2017-01-17/service-2.json,sha256=OEq6r07p5MoRk3j_WRxW-pRgz8Ixyhbg0AOv7t56t5Y,123590 -botocore/data/servicecatalog/2015-12-10/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/servicecatalog/2015-12-10/paginators-1.json,sha256=UXXp0TBwXonzEWro7t006B0QviOiyBvQXYw3n1fEILE,1649 -botocore/data/servicecatalog/2015-12-10/service-2.json,sha256=bdRpHPSh8AJ9bqdg3YiDlRmnQHSNXWnKrAXGwiLMNxQ,220755 -botocore/data/ram/2018-01-04/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/ram/2018-01-04/service-2.json,sha256=PNQEBBMDJQqKbSpzabjEelHp7G6dBQOw6SEDYEUb_ds,48663 -botocore/data/events/2014-02-03/service-2.json,sha256=6wZ7XKpOPLLD453dej8bmrbqZDuyBOT3lGbCl3EUP0E,37700 -botocore/data/events/2015-10-07/examples-1.json,sha256=mPd7boHY9w4xI-wG9j9rE088o-AWzYV37JIZ20tLApc,42 -botocore/data/events/2015-10-07/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/events/2015-10-07/service-2.json,sha256=CB4R6enO_NSxymL9dnlOALob7xvoPjWIEZFhgo3UVAI,62144 -botocore/data/cloud9/2017-09-23/paginators-1.json,sha256=lET7E3FWErLA8In260otKfr3_9oVSr5OTO1zcrBi28w,380 -botocore/data/cloud9/2017-09-23/service-2.json,sha256=6HG5bGNw5sX_omWqLwHJJDW8TosoCQOYMUz8KmAG1BM,26937 -botocore/data/connect/2017-08-08/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/connect/2017-08-08/service-2.json,sha256=a6Mbc2Z2E11IxORDFcNsqQoAV6ae8bO3_EwXTxxuiPQ,83346 -botocore/data/iot-jobs-data/2017-09-29/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/iot-jobs-data/2017-09-29/service-2.json,sha256=Z_D1WR30rGj8w7EEC1I8JkFmmmblB-dHvblo9Lpxe64,20210 -botocore/data/kms/2014-11-01/examples-1.json,sha256=vtB2apRo_qswwRz9RqdwBHFcjJsZxxAUtgpEctOBzX8,37182 -botocore/data/kms/2014-11-01/paginators-1.json,sha256=JdqHUZD-Dp2Aw-FAvmmFnGJu6jlG_4IstL9IngWJ-zE,777 -botocore/data/kms/2014-11-01/service-2.json,sha256=mbDa2-3Rc24m825gLVVln3vpnnOtGbAZ8ciU2-ntiuA,176829 -botocore/data/cloudsearchdomain/2013-01-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cloudsearchdomain/2013-01-01/service-2.json,sha256=35-MVRfJCSogOlXaE3cqiuRsrihHiCmWQSI4a5ibtuE,43643 -botocore/data/emr/2009-03-31/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/emr/2009-03-31/waiters-2.json,sha256=pMh5RSVHgFU-DlrH0dSf4IibHo9Hddmg9DvaR4a0Z90,2073 -botocore/data/emr/2009-03-31/paginators-1.json,sha256=99n79cGL-TUhtRI8paNAXSEQow0S-4NU0bYpu0zveSI,799 -botocore/data/emr/2009-03-31/service-2.json,sha256=9ESvebu0u9DxdWkPdvfROgYFzheWNtdxZw70rTyxvS4,169059 -botocore/data/iot1click-projects/2018-05-14/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/iot1click-projects/2018-05-14/service-2.json,sha256=5ruAZaa_8vSlfh6iofgS0mbfCC2gmIovhypIM1jRU3w,29680 -botocore/data/efs/2015-02-01/examples-1.json,sha256=OHPM_hAlvaNIBYXnUbEvgNzhqfGYK7fR7S7iIhpcarc,6454 -botocore/data/efs/2015-02-01/paginators-1.json,sha256=Aa6anup_5bXZxDamNHHtkSv0qhzisc5sxGsZQxI71u8,517 -botocore/data/efs/2015-02-01/service-2.json,sha256=xUkefhx2HedV_LICe5k0izxOaSsSM8BE0csoziDuphE,55989 -botocore/data/sts/2011-06-15/examples-1.json,sha256=3Zxrln-XpbZd4B_sF7M4lysyRvf3gNoSHWV0A2igILE,8797 -botocore/data/sts/2011-06-15/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/sts/2011-06-15/service-2.json,sha256=e_5ozwT2WWB0hUVCIkWUp5gZlTUgzmC3_jIjFGnb6Jo,80598 -botocore/data/workmail/2017-10-01/paginators-1.json,sha256=I_nsf6YshZDDeKJIqYToEaNPvYTle5SEkQl1SdC2CH8,1008 -botocore/data/workmail/2017-10-01/service-2.json,sha256=_nQumrrhfQTO1-hr0Wo7KCxSgs06Ir4qutzvuzKyJkg,71469 -botocore/data/medialive/2017-10-14/paginators-1.json,sha256=knb47RWyALtk2NlKM2Shceh7OtTX5TTNV96qus1EWD8,1036 -botocore/data/medialive/2017-10-14/service-2.json,sha256=PeHDs2-HVoF7HAR5oJSzj2weIp2yBy_6aJ0hu5MFw3k,349355 -botocore/data/fms/2018-01-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/fms/2018-01-01/service-2.json,sha256=nCNUJVWiwLzDjbKx7qUqdME2Wv82RzYhdq90hFtEegY,37290 -botocore/data/firehose/2015-08-04/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/firehose/2015-08-04/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/firehose/2015-08-04/service-2.json,sha256=M2nKjBzsmdPPAlGUhEQ119yUDeM7qv6IITcUcavl-8U,122083 -botocore/data/workspaces/2015-04-08/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/workspaces/2015-04-08/paginators-1.json,sha256=sjHTw0FVva58Yppf7TpCT8YiUHXT_PSsNFA3xYCiwtU,478 -botocore/data/workspaces/2015-04-08/service-2.json,sha256=EIdOncKtLh5LCV2CPTUF26wPpNTjas4l0pfqpG5Q16I,78870 -botocore/data/xray/2016-04-12/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/xray/2016-04-12/paginators-1.json,sha256=JukFLAgcGm8Al_7cURDX0Y5jCpEa5viqifStuIgzxFU,556 -botocore/data/xray/2016-04-12/service-2.json,sha256=fXxGHYePFNd2lhhj18V7BwdfKF6Q7s7fGQEydkxmStk,73904 -botocore/data/dlm/2018-01-12/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/dlm/2018-01-12/service-2.json,sha256=v2ITFC1bM8A7-ZOS07BE2WcbYrjaCseDmYDvpJ_x5gs,18085 -botocore/data/cloudfront/2015-04-17/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2015-04-17/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2015-04-17/service-2.json,sha256=OJbOdEYaGCEcGUoGaEvTb0Il4dCf9sQ8ZAvHpsCtOFs,150842 -botocore/data/cloudfront/2014-10-21/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2014-10-21/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2014-10-21/service-2.json,sha256=E0Umk_pX7ll7dTLiqRagIHKZiRLmaYvN6-t9_jZU16s,147479 -botocore/data/cloudfront/2015-09-17/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2015-09-17/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2015-09-17/service-2.json,sha256=DkSmH6crv4IoVJ_aqqnABOsD9P5YLabp8PmkrT_pQyI,130784 -botocore/data/cloudfront/2014-05-31/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2014-05-31/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2014-05-31/service-2.json,sha256=4MdA1whbH4xS6nxk9Bbq_20w7Utc5L38lQv5WmOzR_c,144492 -botocore/data/cloudfront/2016-11-25/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cloudfront/2016-11-25/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2016-11-25/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2016-11-25/service-2.json,sha256=C9ZmNpON37wQO9z2ybGc_xp8bpXvuCf8FIyLQezg4yQ,197970 -botocore/data/cloudfront/2016-09-07/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2016-09-07/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2016-09-07/service-2.json,sha256=hex7sCwsKiyCriVT6wX-zlX5dIbEFq3s0VYoaLasdYo,151766 -botocore/data/cloudfront/2016-09-29/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2016-09-29/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2016-09-29/service-2.json,sha256=65iFTwzLzBiLeeiq6DlM_xPa5Rf0KXbJw6Lm6Gx6zZ0,194806 -botocore/data/cloudfront/2016-08-20/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2016-08-20/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2016-08-20/service-2.json,sha256=A_bOItD3n7BIUEUCChsppdZF53QmZTh6dr7u-GQsV70,150982 -botocore/data/cloudfront/2017-03-25/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cloudfront/2017-03-25/waiters-2.json,sha256=JboqzXjlni8p-wiVKBz1jRj-mFpkryqueCgI1hD7WPA,1184 -botocore/data/cloudfront/2017-03-25/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2017-03-25/service-2.json,sha256=FYENqjVgG09p7vwNe24ENePH9hTZdDXScd4INlTblAo,206093 -botocore/data/cloudfront/2016-01-13/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2016-01-13/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2016-01-13/service-2.json,sha256=Ej9MObIm0JhxshQMQnOwYJ4vB0OaIt_WNPPUs4w1jRw,133880 -botocore/data/cloudfront/2018-06-18/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cloudfront/2018-06-18/waiters-2.json,sha256=JboqzXjlni8p-wiVKBz1jRj-mFpkryqueCgI1hD7WPA,1184 -botocore/data/cloudfront/2018-06-18/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2018-06-18/service-2.json,sha256=NuGTf1rjaEfCNkrQ4kN5Y78lIkNfiDc2C0K1mDPFrm0,267331 -botocore/data/cloudfront/2017-10-30/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cloudfront/2017-10-30/waiters-2.json,sha256=JboqzXjlni8p-wiVKBz1jRj-mFpkryqueCgI1hD7WPA,1184 -botocore/data/cloudfront/2017-10-30/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2017-10-30/service-2.json,sha256=mDjyofrasyhvEUbC9THtbQWV9xQ2qVXneayrak1XCwo,264716 -botocore/data/cloudfront/2018-11-05/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/cloudfront/2018-11-05/waiters-2.json,sha256=JboqzXjlni8p-wiVKBz1jRj-mFpkryqueCgI1hD7WPA,1184 -botocore/data/cloudfront/2018-11-05/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2018-11-05/service-2.json,sha256=y--2DnK94Lb7SO65PgueFvMGYY_w6cmzmzHgMnhaxi0,273141 -botocore/data/cloudfront/2016-01-28/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2016-01-28/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2016-01-28/service-2.json,sha256=YovRuitkg8V3QowW867Z4ADqMFkZZvH2xhk6NWg3tNY,133424 -botocore/data/cloudfront/2016-08-01/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2016-08-01/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2016-08-01/service-2.json,sha256=gyNH67busvLNPkXdPe8vT_R1_7kaOFrehY1vZTQ-m0k,148384 -botocore/data/cloudfront/2015-07-27/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2015-07-27/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2015-07-27/service-2.json,sha256=a7NsU2TTqmBpbWyEQ1HPaIzTKpErk8Vh2jTL8bnAiQU,154636 -botocore/data/cloudfront/2014-11-06/waiters-2.json,sha256=jzREqDxfIg2KbmPYOmDoYgDvy8mWAEK0w_NmEoCqhHI,1184 -botocore/data/cloudfront/2014-11-06/paginators-1.json,sha256=I7u4h1MFflBvFJemcrLHSn7uOrEeDFc7ecWGqwDxGF8,1126 -botocore/data/cloudfront/2014-11-06/service-2.json,sha256=SOKAXJJdFK2fZsAJnfIMCTBKm2r6h4IaoCcR837dGAM,147700 -botocore/data/kinesis-video-archived-media/2017-09-30/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/kinesis-video-archived-media/2017-09-30/service-2.json,sha256=ZpHUopWaSaS3Iq15umF4z7kC6ICSgEmZnVDMVo3hUwg,31504 -botocore/data/sagemaker-runtime/2017-05-13/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/sagemaker-runtime/2017-05-13/service-2.json,sha256=a3xStr8drzfo5DtoCp1XzHsGhW7c1573WKzKmrJ_6N8,6891 -botocore/data/shield/2016-06-02/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/shield/2016-06-02/paginators-1.json,sha256=agyekliT3Svz5ckCuaTOZWCqm1POqPDsGWHoVBbmCS0,193 -botocore/data/shield/2016-06-02/service-2.json,sha256=h5fKSwLXv5REcZkAf9TUN0D4WjkYfHUoD-6mNs2zjyk,49041 -botocore/data/mediastore/2017-09-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/mediastore/2017-09-01/service-2.json,sha256=cwjcxbuUVzoD0w4xLPxOqbcauVnzlKf1GuT95sUtZfk,22711 -botocore/data/iam/2010-05-08/examples-1.json,sha256=erkX6JZCsLnpN3_S6IEFxMhmYQ3GS0hlhkOtmm1iq34,36635 -botocore/data/iam/2010-05-08/waiters-2.json,sha256=F-Mb0RKiCBuQdP1xHtSImfTeAfPKMOJ0Aa2OPKX3CPA,754 -botocore/data/iam/2010-05-08/paginators-1.json,sha256=xZxMQv6sHIZJXlT70hkMw5wd7Y68TyjgGHExmUAC-BE,5484 -botocore/data/iam/2010-05-08/service-2.json,sha256=uVBZzLIWa8aAyLsEYADspe1inSKE9KuwXR5KkE4JqoU,471864 -botocore/data/robomaker/2018-06-29/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/robomaker/2018-06-29/service-2.json,sha256=OOV_8SJV1cQ6vK0ItKexuPSJeu8TuaeQ5GAc_fCUwKI,104222 -botocore/data/codebuild/2016-10-06/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/codebuild/2016-10-06/paginators-1.json,sha256=qdcaibyPtPLLq_gSrRS4R0Ya4uWfkXZhCGSgRt5KOiw,408 -botocore/data/codebuild/2016-10-06/service-2.json,sha256=vMRUq9baAUMIJn0DG7kmkI-y26u0moNbk6rfeZMe2dk,95068 -botocore/data/elastictranscoder/2012-09-25/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/elastictranscoder/2012-09-25/waiters-2.json,sha256=ePD8qEyUXJMnroVmvrubritF3re95gdBAETq6do-Uh8,613 -botocore/data/elastictranscoder/2012-09-25/paginators-1.json,sha256=xHyxPQTUGKK7Vj_z_1E46xAI6BwZC8IvDFuZ3DXD4BY,559 -botocore/data/elastictranscoder/2012-09-25/service-2.json,sha256=rEuZOQoR0ZsOxhfX8KT4SHdRHUeU5FBp7REdjj_WODo,201124 -botocore/data/codecommit/2015-04-13/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/codecommit/2015-04-13/paginators-1.json,sha256=2w92BpzUce0gSVEaZH0la2r8ZT_MDtxoLc6RG-dpln4,1206 -botocore/data/codecommit/2015-04-13/service-2.json,sha256=uCj6wMcKcJFUyF2Zv5eefW7rLBMN3-1f0S-6RuTecbA,166716 -botocore/data/comprehendmedical/2018-10-30/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/comprehendmedical/2018-10-30/service-2.json,sha256=q9OszLZjr_8M_9WpkiAmaLfjjqueUU7gcFiMTO1Muzs,12916 -botocore/data/alexaforbusiness/2017-11-09/paginators-1.json,sha256=BRE0mRiSy6eBdbcYm3UZrH1kR5SDI0c12RhxTyhrXuo,1157 -botocore/data/alexaforbusiness/2017-11-09/service-2.json,sha256=kucAvrSU9eOU2zqfcyVMp92a0ox_WqXKVdZbCHOV9z0,129671 -botocore/data/mediatailor/2018-04-23/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/mediatailor/2018-04-23/service-2.json,sha256=ZarDVER458ZNWKu6iU_PYYfrZ4kbtpQ6SDCxnVhRpFs,19535 -botocore/data/greengrass/2017-06-07/service-2.json,sha256=xCFRtZ8l_B16D5gUmd7045oekGBa5BnNhE4er3vfghI,200528 -botocore/data/dax/2017-04-19/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/dax/2017-04-19/service-2.json,sha256=PKefwNWKpuZUeYnG4p_2ZMidKkw7JVe9zIFwIGJhMJY,65718 -botocore/data/sqs/2012-11-05/examples-1.json,sha256=bJnIBXjhLT_DRHXlx6wuYZVi1EY-RUp_ijhgfnGklaY,1108 -botocore/data/sqs/2012-11-05/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/sqs/2012-11-05/service-2.json,sha256=QA50ga33ee_FWAwKGCOhEdeeZxzj5kwcwHqmg-j04RQ,114522 -botocore/data/discovery/2015-11-01/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/discovery/2015-11-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/discovery/2015-11-01/service-2.json,sha256=eeVnWXqP2bam_0PgOv68UjMN6vsZZ0VnyQ0ht2zn9i4,68810 -botocore/data/cloudhsmv2/2017-04-28/paginators-1.json,sha256=VvCnjrdoGz3Lb-gi5YSOAhhAHzB50i0vIks0GaA2nS0,512 -botocore/data/cloudhsmv2/2017-04-28/service-2.json,sha256=xmAWbKjYIXV5Np548_zDYrYX5Gc6JQSNMZRetffOY9Q,35980 -botocore/data/waf/2015-08-24/examples-1.json,sha256=6OPuCnLynJIfGO-Vxhb9ZZV9ktEKhpByvf2jSwAg-DY,29749 -botocore/data/waf/2015-08-24/paginators-1.json,sha256=Ws9sSrbq36BodFZujdARARMlU7SpMqvkkGwhzvs9KYk,1190 -botocore/data/waf/2015-08-24/service-2.json,sha256=aoc-erfgGHOcDfI3Pyc4mRddwP87pcrG90ApawrYsd8,312157 -botocore/data/logs/2014-03-28/examples-1.json,sha256=K3b6mgYkitvcecSlJT-iV_EQATmvOySs66iKJI5qx0g,44 -botocore/data/logs/2014-03-28/paginators-1.json,sha256=p8mepYgcgciWp5-IyFpWfhL5tHoyzd6mlXTsaM0ufP4,1082 -botocore/data/logs/2014-03-28/service-2.json,sha256=jHl38pL-Pai7N_odqLQblzHIvS8W3c2LV_4F3pjhkjk,98237 -botocore/data/lambda/2014-11-11/service-2.json,sha256=PJ47oYyRWSO7m307osuRTkqGZRfMnbIeaDmPRmHfaQQ,38698 -botocore/data/lambda/2015-03-31/examples-1.json,sha256=Mbl7lTSfHcXzjPZeM26psMXIsVzL19gKSTzMvmtBgvI,17969 -botocore/data/lambda/2015-03-31/paginators-1.json,sha256=atQs58V54JCN3VGq61LykUVEXWWlHMj8vUAzxxbqg1Q,521 -botocore/data/lambda/2015-03-31/service-2.json,sha256=Vp3n6dHSYhPkqth16wtrymZVg0dy4Y-wiyd0lcArXKY,143440 -botocore/data/quicksight/2018-04-01/paginators-1.json,sha256=hIQ7AbLBsY4fPSNLVMg0dS45m6cjZKFTjbp3ZLh4zj8,23 -botocore/data/quicksight/2018-04-01/service-2.json,sha256=BJLuoJNAbp77daHePrc8dfMVhamETV4858ght413Eh0,54594 -botocore-1.12.61.dist-info/WHEEL,sha256=AvR0WeTpDaxT645bl5FQxUK6NPsTls2ttpcGJg3j1Xg,110 -botocore-1.12.61.dist-info/DESCRIPTION.rst,sha256=4WxqZlSD_Xrd6Gz9vblSW6spBTdNJcmrxViUOIPJl5o,1390 -botocore-1.12.61.dist-info/metadata.json,sha256=yrrh3hErIi9Y9L2bAIkh8gb8DY5fbC4JbmFprThq9VY,1615 -botocore-1.12.61.dist-info/METADATA,sha256=jBy4GndChhpOjPEtTyupu8EXvySa_XXCUKuLywJZXZ4,2923 -botocore-1.12.61.dist-info/RECORD,, -botocore-1.12.61.dist-info/top_level.txt,sha256=IdlNr9dnwi3lQt66dKnShE5HBUhIqBFqJmVhm11aijk,9 -botocore-1.12.61.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 -botocore/vendored/requests/packages/chardet/codingstatemachine.pyc,, -botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/_implementation.pyc,, -botocore/vendored/requests/packages/urllib3/contrib/ntlmpool.pyc,, -botocore/errorfactory.pyc,, -botocore/vendored/requests/packages/urllib3/connectionpool.pyc,, -botocore/docs/docstring.pyc,, -botocore/vendored/requests/packages/urllib3/util/request.pyc,, -botocore/__init__.pyc,, -botocore/vendored/requests/packages/urllib3/util/retry.pyc,, -botocore/docs/paginator.pyc,, -botocore/vendored/requests/packages/chardet/sbcharsetprober.pyc,, -botocore/vendored/six.pyc,, -botocore/stub.pyc,, -botocore/vendored/requests/packages/urllib3/fields.pyc,, -botocore/vendored/requests/packages/urllib3/exceptions.pyc,, -botocore/model.pyc,, -botocore/vendored/requests/packages/chardet/cp949prober.pyc,, -botocore/vendored/requests/packages/chardet/langthaimodel.pyc,, -botocore/compat.pyc,, -botocore/handlers.pyc,, -botocore/vendored/requests/packages/chardet/big5freq.pyc,, -botocore/vendored/requests/packages/chardet/mbcssm.pyc,, -botocore/vendored/requests/packages/chardet/utf8prober.pyc,, -botocore/docs/__init__.pyc,, -botocore/docs/service.pyc,, -botocore/paginate.pyc,, -botocore/vendored/requests/packages/chardet/latin1prober.pyc,, -botocore/vendored/requests/status_codes.pyc,, -botocore/eventstream.pyc,, -botocore/vendored/requests/packages/urllib3/request.pyc,, -botocore/vendored/requests/packages/urllib3/packages/__init__.pyc,, -botocore/parsers.pyc,, -botocore/docs/waiter.pyc,, -botocore/vendored/requests/packages/chardet/eucjpprober.pyc,, -botocore/vendored/requests/packages/chardet/constants.pyc,, -botocore/vendored/requests/packages/urllib3/contrib/__init__.pyc,, -botocore/awsrequest.pyc,, -botocore/vendored/requests/sessions.pyc,, -botocore/docs/bcdoc/restdoc.pyc,, -botocore/vendored/requests/packages/urllib3/packages/ordered_dict.pyc,, -botocore/validate.pyc,, -botocore/vendored/requests/packages/chardet/big5prober.pyc,, -botocore/vendored/requests/packages/urllib3/util/__init__.pyc,, -botocore/vendored/requests/packages/urllib3/util/timeout.pyc,, -botocore/endpoint.pyc,, -botocore/response.pyc,, -botocore/vendored/requests/packages/chardet/escprober.pyc,, -botocore/vendored/requests/utils.pyc,, -botocore/vendored/requests/cookies.pyc,, -botocore/vendored/requests/packages/urllib3/util/ssl_.pyc,, -botocore/vendored/requests/packages/chardet/__init__.pyc,, -botocore/vendored/requests/packages/chardet/hebrewprober.pyc,, -botocore/vendored/requests/packages/chardet/chardistribution.pyc,, -botocore/vendored/requests/packages/chardet/gb2312prober.pyc,, -botocore/docs/bcdoc/docstringparser.pyc,, -botocore/vendored/requests/packages/chardet/euckrfreq.pyc,, -botocore/docs/client.pyc,, -botocore/vendored/requests/packages/urllib3/util/connection.pyc,, -botocore/vendored/requests/packages/chardet/sbcsgroupprober.pyc,, -botocore/vendored/requests/packages/chardet/compat.pyc,, -botocore/vendored/requests/packages/chardet/euctwprober.pyc,, -botocore/vendored/requests/packages/urllib3/filepost.pyc,, -botocore/vendored/requests/packages/chardet/mbcsgroupprober.pyc,, -botocore/utils.pyc,, -botocore/vendored/requests/api.pyc,, -botocore/vendored/requests/packages/chardet/langbulgarianmodel.pyc,, -botocore/docs/example.pyc,, -botocore/vendored/requests/packages/urllib3/__init__.pyc,, -botocore/vendored/requests/packages/urllib3/contrib/pyopenssl.pyc,, -botocore/vendored/requests/packages/chardet/universaldetector.pyc,, -botocore/docs/bcdoc/__init__.pyc,, -botocore/vendored/requests/models.pyc,, -botocore/vendored/requests/packages/chardet/escsm.pyc,, -botocore/vendored/requests/packages/chardet/langcyrillicmodel.pyc,, -botocore/httpsession.pyc,, -botocore/vendored/requests/auth.pyc,, -botocore/credentials.pyc,, -botocore/vendored/requests/packages/chardet/langhebrewmodel.pyc,, -botocore/loaders.pyc,, -botocore/docs/params.pyc,, -botocore/vendored/requests/packages/chardet/charsetprober.pyc,, -botocore/vendored/requests/exceptions.pyc,, -botocore/retryhandler.pyc,, -botocore/vendored/requests/packages/urllib3/response.pyc,, -botocore/vendored/requests/packages/chardet/euctwfreq.pyc,, -botocore/docs/sharedexample.pyc,, -botocore/waiter.pyc,, -botocore/args.pyc,, -botocore/vendored/requests/certs.pyc,, -botocore/docs/bcdoc/docevents.pyc,, -botocore/vendored/requests/packages/chardet/charsetgroupprober.pyc,, -botocore/configprovider.pyc,, -botocore/docs/bcdoc/style.pyc,, -botocore/hooks.pyc,, -botocore/vendored/requests/packages/urllib3/packages/six.pyc,, -botocore/config.pyc,, -botocore/vendored/requests/packages/chardet/langhungarianmodel.pyc,, -botocore/docs/shape.pyc,, -botocore/client.pyc,, -botocore/vendored/requests/packages/chardet/gb2312freq.pyc,, -botocore/docs/utils.pyc,, -botocore/auth.pyc,, -botocore/configloader.pyc,, -botocore/vendored/requests/packages/chardet/sjisprober.pyc,, -botocore/vendored/requests/packages/__init__.pyc,, -botocore/docs/bcdoc/textwriter.pyc,, -botocore/serialize.pyc,, -botocore/vendored/requests/__init__.pyc,, -botocore/vendored/requests/structures.pyc,, -botocore/vendored/requests/packages/chardet/jisfreq.pyc,, -botocore/vendored/requests/packages/chardet/mbcharsetprober.pyc,, -botocore/exceptions.pyc,, -botocore/vendored/requests/hooks.pyc,, -botocore/session.pyc,, -botocore/docs/method.pyc,, -botocore/history.pyc,, -botocore/vendored/requests/adapters.pyc,, -botocore/vendored/requests/packages/chardet/chardetect.pyc,, -botocore/vendored/requests/packages/urllib3/util/url.pyc,, -botocore/vendored/__init__.pyc,, -botocore/vendored/requests/packages/chardet/langgreekmodel.pyc,, -botocore/vendored/requests/packages/urllib3/connection.pyc,, -botocore/vendored/requests/packages/urllib3/packages/ssl_match_hostname/__init__.pyc,, -botocore/vendored/requests/packages/urllib3/_collections.pyc,, -botocore/vendored/requests/packages/chardet/jpcntx.pyc,, -botocore/vendored/requests/packages/urllib3/poolmanager.pyc,, -botocore/vendored/requests/packages/urllib3/util/response.pyc,, -botocore/regions.pyc,, -botocore/vendored/requests/compat.pyc,, -botocore/translate.pyc,, -botocore/vendored/requests/packages/chardet/euckrprober.pyc,, -botocore/signers.pyc,, diff --git a/bin/botocore-1.12.61.dist-info/WHEEL b/bin/botocore-1.12.61.dist-info/WHEEL deleted file mode 100644 index 9dff69d8..00000000 --- a/bin/botocore-1.12.61.dist-info/WHEEL +++ /dev/null @@ -1,6 +0,0 @@ -Wheel-Version: 1.0 -Generator: bdist_wheel (0.24.0) -Root-Is-Purelib: true -Tag: py2-none-any -Tag: py3-none-any - diff --git a/bin/botocore-1.12.61.dist-info/metadata.json b/bin/botocore-1.12.61.dist-info/metadata.json deleted file mode 100644 index 9ecaae1b..00000000 --- a/bin/botocore-1.12.61.dist-info/metadata.json +++ /dev/null @@ -1 +0,0 @@ -{"license": "Apache License 2.0", "name": "botocore", "metadata_version": "2.0", "generator": "bdist_wheel (0.24.0)", "summary": "Low-level, data-driven core of boto 3.", "run_requires": [{"environment": "python_version==\"3.3\"", "requires": ["urllib3>=1.20,<1.23"]}, {"requires": ["jmespath>=0.7.1,<1.0.0", "docutils>=0.10"]}, {"environment": "python_version==\"2.6\"", "requires": ["python-dateutil>=2.1,<2.7.0", "ordereddict==1.1", "simplejson==3.3.0", "urllib3>=1.20,<1.24"]}, {"environment": "python_version==\"2.7\"", "requires": ["urllib3>=1.20,<1.25"]}, {"environment": "python_version>=\"3.4\"", "requires": ["urllib3>=1.20,<1.25"]}, {"environment": "python_version>=\"2.7\"", "requires": ["python-dateutil>=2.1,<3.0.0"]}], "version": "1.12.61", "extensions": {"python.details": {"project_urls": {"Home": "https://github.com/boto/botocore"}, "document_names": {"description": "DESCRIPTION.rst"}, "contacts": [{"role": "author", "name": "Amazon Web Services"}]}}, "classifiers": ["Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "Natural Language :: English", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7"], "extras": []} \ No newline at end of file diff --git a/bin/botocore-1.12.61.dist-info/top_level.txt b/bin/botocore-1.12.61.dist-info/top_level.txt deleted file mode 100644 index c5b9e129..00000000 --- a/bin/botocore-1.12.61.dist-info/top_level.txt +++ /dev/null @@ -1 +0,0 @@ -botocore diff --git a/bin/botocore/__init__.py b/bin/botocore/__init__.py index a4702b2e..b258dabb 100644 --- a/bin/botocore/__init__.py +++ b/bin/botocore/__init__.py @@ -16,7 +16,7 @@ import re import logging -__version__ = '1.12.61' +__version__ = '1.12.171' class NullHandler(logging.Handler): diff --git a/bin/botocore/__init__.pyc b/bin/botocore/__init__.pyc deleted file mode 100644 index 01b12a16..00000000 Binary files a/bin/botocore/__init__.pyc and /dev/null differ diff --git a/bin/botocore/args.py b/bin/botocore/args.py index d6fcc20a..3acdc102 100644 --- a/bin/botocore/args.py +++ b/bin/botocore/args.py @@ -21,6 +21,7 @@ import socket import botocore.serialize +import botocore.utils from botocore.signers import RequestSigner from botocore.config import Config from botocore.endpoint import EndpointCreator @@ -110,7 +111,7 @@ def compute_client_args(self, service_model, client_config, elif scoped_config: raw_value = scoped_config.get('parameter_validation') if raw_value is not None: - parameter_validation = self._ensure_boolean(raw_value) + parameter_validation = botocore.utils.ensure_boolean(raw_value) endpoint_config = endpoint_bridge.resolve( service_name, region_name, endpoint_url, is_secure) @@ -199,7 +200,7 @@ def _convert_config_to_bool(self, config_dict, keys): config_copy = config_dict.copy() present_keys = [k for k in keys if k in config_copy] for key in present_keys: - config_copy[key] = self._ensure_boolean(config_copy[key]) + config_copy[key] = botocore.utils.ensure_boolean(config_copy[key]) return config_copy def _get_default_s3_region(self, service_name, endpoint_bridge): diff --git a/bin/botocore/args.pyc b/bin/botocore/args.pyc deleted file mode 100644 index 3e39e562..00000000 Binary files a/bin/botocore/args.pyc and /dev/null differ diff --git a/bin/botocore/auth.pyc b/bin/botocore/auth.pyc deleted file mode 100644 index 717eefa9..00000000 Binary files a/bin/botocore/auth.pyc and /dev/null differ diff --git a/bin/botocore/awsrequest.py b/bin/botocore/awsrequest.py index a56ec412..f2fd925e 100644 --- a/bin/botocore/awsrequest.py +++ b/bin/botocore/awsrequest.py @@ -315,7 +315,7 @@ def create_request_object(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']) + request_object.context = r['context'] return request_object diff --git a/bin/botocore/awsrequest.pyc b/bin/botocore/awsrequest.pyc deleted file mode 100644 index bb9033ba..00000000 Binary files a/bin/botocore/awsrequest.pyc and /dev/null differ diff --git a/bin/botocore/client.py b/bin/botocore/client.py index 4625fdc5..f7b3a99d 100644 --- a/bin/botocore/client.py +++ b/bin/botocore/client.py @@ -38,6 +38,10 @@ # "from botocore.client import Config". from botocore.config import Config from botocore.history import get_global_history_recorder +from botocore.discovery import ( + EndpointDiscoveryHandler, EndpointDiscoveryManager, + block_endpoint_discovery_required_operations +) logger = logging.getLogger(__name__) @@ -48,7 +52,8 @@ 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): + response_parser_factory=None, exceptions_factory=None, + config_store=None): self._loader = loader self._endpoint_resolver = endpoint_resolver self._user_agent = user_agent @@ -57,6 +62,11 @@ def __init__(self, loader, endpoint_resolver, user_agent, event_emitter, self._retry_config_translator = retry_config_translator self._response_parser_factory = response_parser_factory self._exceptions_factory = exceptions_factory + # TODO: Migrate things away from scoped_config in favor of the + # config_store. The config store can pull things from both the scoped + # config and environment variables (and potentially more in the + # future). + self._config_store = config_store def create_client(self, service_name, region_name, is_secure=True, endpoint_url=None, verify=None, @@ -79,6 +89,9 @@ def create_client(self, service_name, region_name, is_secure=True, self._register_s3_events( service_client, endpoint_bridge, endpoint_url, client_config, scoped_config) + self._register_endpoint_discovery( + service_client, endpoint_url, client_config + ) return service_client def create_client_class(self, service_name, api_version=None): @@ -132,6 +145,30 @@ def _register_retries(self, client): unique_id=unique_id ) + def _register_endpoint_discovery(self, client, endpoint_url, config): + if endpoint_url is not None: + # Don't register any handlers in the case of a custom endpoint url + return + # Only attach handlers if the service supports discovery + if client.meta.service_model.endpoint_discovery_operation is None: + return + events = client.meta.events + service_id = client.meta.service_model.service_id.hyphenize() + enabled = False + if config and config.endpoint_discovery_enabled is not None: + enabled = config.endpoint_discovery_enabled + elif self._config_store: + enabled = self._config_store.get_config_variable( + 'endpoint_discovery_enabled') + if enabled: + manager = EndpointDiscoveryManager(client) + handler = EndpointDiscoveryHandler(manager) + handler.register(events, service_id) + else: + events.register('before-parameter-build', + block_endpoint_discovery_required_operations) + + def _register_s3_events(self, client, endpoint_bridge, endpoint_url, client_config, scoped_config): if client.meta.service_model.service_name != 's3': @@ -607,8 +644,8 @@ def _make_api_call(self, operation_name, api_params): if event_response is not None: http, parsed_response = event_response else: - http, parsed_response = self._endpoint.make_request( - operation_model, request_dict) + http, parsed_response = self._make_request( + operation_model, request_dict, request_context) self.meta.events.emit( 'after-call.{service_id}.{operation_name}'.format( @@ -625,6 +662,18 @@ def _make_api_call(self, operation_name, api_params): else: return parsed_response + def _make_request(self, operation_model, request_dict, request_context): + try: + return self._endpoint.make_request(operation_model, request_dict) + except Exception as e: + self.meta.events.emit( + 'after-call-error.{service_id}.{operation_name}'.format( + service_id=self._service_model.service_id.hyphenize(), + operation_name=operation_model.name), + exception=e, context=request_context + ) + raise + def _convert_to_request_dict(self, api_params, operation_model, context=None): api_params = self._emit_api_params( diff --git a/bin/botocore/client.pyc b/bin/botocore/client.pyc deleted file mode 100644 index 30f53a98..00000000 Binary files a/bin/botocore/client.pyc and /dev/null differ diff --git a/bin/botocore/compat.pyc b/bin/botocore/compat.pyc deleted file mode 100644 index 238af788..00000000 Binary files a/bin/botocore/compat.pyc and /dev/null differ diff --git a/bin/botocore/config.py b/bin/botocore/config.py index c59cc7dd..038d17eb 100644 --- a/bin/botocore/config.py +++ b/bin/botocore/config.py @@ -35,12 +35,12 @@ class Config(object): :param user_agent_extra: The value to append to the current User-Agent header value. - :type connect_timeout: int + :type connect_timeout: float or 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 + :type read_timeout: float or 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. @@ -137,6 +137,7 @@ class Config(object): ('retries', None), ('client_cert', None), ('inject_host_prefix', True), + ('endpoint_discovery_enabled', None), ]) def __init__(self, *args, **kwargs): diff --git a/bin/botocore/config.pyc b/bin/botocore/config.pyc deleted file mode 100644 index db77baa7..00000000 Binary files a/bin/botocore/config.pyc and /dev/null differ diff --git a/bin/botocore/configloader.pyc b/bin/botocore/configloader.pyc deleted file mode 100644 index 0f121757..00000000 Binary files a/bin/botocore/configloader.pyc and /dev/null differ diff --git a/bin/botocore/configprovider.py b/bin/botocore/configprovider.py index b1514b62..90ad0ef4 100644 --- a/bin/botocore/configprovider.py +++ b/bin/botocore/configprovider.py @@ -15,6 +15,8 @@ """ import os +from botocore import utils + #: 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. @@ -65,6 +67,17 @@ 'metadata_service_num_attempts', 'AWS_METADATA_SERVICE_NUM_ATTEMPTS', 1, int), 'parameter_validation': ('parameter_validation', None, True, None), + # Client side monitoring configurations. + # Note: These configurations are considered internal to botocore. + # Do not use them until publicly documented. + 'csm_enabled': ( + 'csm_enabled', 'AWS_CSM_ENABLED', False, utils.ensure_boolean), + 'csm_port': ('csm_port', 'AWS_CSM_PORT', 31000, int), + 'csm_client_id': ('csm_client_id', 'AWS_CSM_CLIENT_ID', '', None), + # Endpoint discovery configuration + 'endpoint_discovery_enabled': ( + 'endpoint_discovery_enabled', 'AWS_ENDPOINT_DISCOVERY_ENABLED', + False, utils.ensure_boolean), } diff --git a/bin/botocore/configprovider.pyc b/bin/botocore/configprovider.pyc deleted file mode 100644 index cd7f7a18..00000000 Binary files a/bin/botocore/configprovider.pyc and /dev/null differ diff --git a/bin/botocore/credentials.py b/bin/botocore/credentials.py index 0bc20f99..5f3cb3bf 100644 --- a/bin/botocore/credentials.py +++ b/bin/botocore/credentials.py @@ -699,16 +699,20 @@ def _get_credentials(self): def _assume_role_kwargs(self): """Get the arguments for assume role based on current configuration.""" - assume_role_kwargs = self._assume_kwargs + assume_role_kwargs = deepcopy(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 + duration_seconds = assume_role_kwargs.get('DurationSeconds') + + if duration_seconds is not None: + assume_role_kwargs['DurationSeconds'] = duration_seconds + return assume_role_kwargs def _create_client(self): @@ -917,7 +921,10 @@ def load(self): """ Search for credentials in explicit environment variables. """ - if self._mapping['access_key'] in self.environ: + + access_key = self.environ.get(self._mapping['access_key'], '') + + if access_key: logger.info('Found credentials in environment variables.') fetcher = self._create_credentials_fetcher() credentials = fetcher(require_expiry=False) @@ -946,30 +953,32 @@ def _create_credentials_fetcher(self): def fetch_credentials(require_expiry=True): credentials = {} - access_key = environ.get(mapping['access_key']) - if access_key is None: + access_key = environ.get(mapping['access_key'], '') + if not access_key: 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: + secret_key = environ.get(mapping['secret_key'], '') + if not secret_key: raise PartialCredentialsError( provider=method, cred_var=mapping['secret_key']) credentials['secret_key'] = secret_key - token = None + credentials['token'] = None for token_env_var in mapping['token']: - if token_env_var in environ: - token = environ[token_env_var] + token = environ.get(token_env_var, '') + if token: + credentials['token'] = token break - credentials['token'] = token - expiry_time = environ.get(mapping['expiry_time']) - if require_expiry and expiry_time is None: + credentials['expiry_time'] = None + expiry_time = environ.get(mapping['expiry_time'], '') + if expiry_time: + credentials['expiry_time'] = expiry_time + if require_expiry and not expiry_time: raise PartialCredentialsError( provider=method, cred_var=mapping['expiry_time']) - credentials['expiry_time'] = expiry_time return credentials @@ -1245,6 +1254,10 @@ def _load_creds_via_assume_role(self, profile_name): if mfa_serial is not None: extra_args['SerialNumber'] = mfa_serial + duration_seconds = role_config.get('duration_seconds') + if duration_seconds is not None: + extra_args['DurationSeconds'] = duration_seconds + fetcher = AssumeRoleCredentialFetcher( client_creator=self._client_creator, source_credentials=source_credentials, @@ -1277,6 +1290,7 @@ def _get_role_config(self, profile_name): mfa_serial = profile.get('mfa_serial') external_id = profile.get('external_id') role_session_name = profile.get('role_session_name') + duration_seconds = profile.get('duration_seconds') role_config = { 'role_arn': role_arn, @@ -1287,6 +1301,12 @@ def _get_role_config(self, profile_name): 'credential_source': credential_source } + if duration_seconds is not None: + try: + role_config['duration_seconds'] = int(duration_seconds) + except ValueError: + pass + # 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: diff --git a/bin/botocore/credentials.pyc b/bin/botocore/credentials.pyc deleted file mode 100644 index f22e8655..00000000 Binary files a/bin/botocore/credentials.pyc and /dev/null differ diff --git a/bin/botocore/data/_retry.json b/bin/botocore/data/_retry.json index 1b00eb8c..f46f0fe3 100644 --- a/bin/botocore/data/_retry.json +++ b/bin/botocore/data/_retry.json @@ -180,7 +180,7 @@ } }, "kinesis": { - "DescribeStream": { + "__default__": { "policies": { "request_limit_exceeded": { "applies_when": { diff --git a/bin/botocore/data/acm-pca/2017-08-22/paginators-1.json b/bin/botocore/data/acm-pca/2017-08-22/paginators-1.json index ea142457..c1f4e234 100644 --- a/bin/botocore/data/acm-pca/2017-08-22/paginators-1.json +++ b/bin/botocore/data/acm-pca/2017-08-22/paginators-1.json @@ -1,3 +1,22 @@ { - "pagination": {} + "pagination": { + "ListCertificateAuthorities": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "CertificateAuthorities" + }, + "ListTags": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Tags" + }, + "ListPermissions": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Permissions" + } + } } diff --git a/bin/botocore/data/acm-pca/2017-08-22/service-2.json b/bin/botocore/data/acm-pca/2017-08-22/service-2.json index f24c7ba6..0d50a4fb 100644 --- a/bin/botocore/data/acm-pca/2017-08-22/service-2.json +++ b/bin/botocore/data/acm-pca/2017-08-22/service-2.json @@ -24,6 +24,7 @@ "errors":[ {"shape":"InvalidArgsException"}, {"shape":"InvalidPolicyException"}, + {"shape":"InvalidTagException"}, {"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.

", @@ -45,9 +46,26 @@ {"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.

", + "documentation":"

Creates an audit report that lists every time that 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 }, + "CreatePermission":{ + "name":"CreatePermission", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreatePermissionRequest"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidArnException"}, + {"shape":"PermissionAlreadyExistsException"}, + {"shape":"LimitExceededException"}, + {"shape":"InvalidStateException"}, + {"shape":"RequestFailedException"} + ], + "documentation":"

Assigns permissions from a private CA to a designated AWS service. Services are specified by their service principals and can be given permission to create and retrieve certificates on a private CA. Services can also be given permission to list the active permissions that the private CA has granted. For ACM to automatically renew your private CA's certificates, you must assign all possible permissions from the CA to the ACM service principal.

At this time, you can only assign permissions to ACM (acm.amazonaws.com). Permissions can be revoked with the DeletePermission operation and listed with the ListPermissions operation.

" + }, "DeleteCertificateAuthority":{ "name":"DeleteCertificateAuthority", "http":{ @@ -61,7 +79,22 @@ {"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.

" + "documentation":"

If the CA is in one of the previously mentioned states and you call DeleteCertificateAuthority, the CA's status changes to DELETED. However, the CA won't be permanently 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 eligible CA, call the RestoreCertificateAuthority operation.

" + }, + "DeletePermission":{ + "name":"DeletePermission", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeletePermissionRequest"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidArnException"}, + {"shape":"InvalidStateException"}, + {"shape":"RequestFailedException"} + ], + "documentation":"

Revokes permissions that a private CA assigned to a designated AWS service. Permissions can be created with the CreatePermission operation and listed with the ListPermissions operation.

" }, "DescribeCertificateAuthority":{ "name":"DescribeCertificateAuthority", @@ -75,7 +108,7 @@ {"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.

" + "documentation":"

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 is permanently deleted. The length of time remaining in the CA's restoration period is also included in this operation's output.

" }, "DescribeCertificateAuthorityAuditReport":{ "name":"DescribeCertificateAuthorityAuditReport", @@ -192,6 +225,23 @@ ], "documentation":"

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

" }, + "ListPermissions":{ + "name":"ListPermissions", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListPermissionsRequest"}, + "output":{"shape":"ListPermissionsResponse"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidArnException"}, + {"shape":"InvalidNextTokenException"}, + {"shape":"InvalidStateException"}, + {"shape":"RequestFailedException"} + ], + "documentation":"

Lists all the permissions, if any, that have been assigned by a private CA. Permissions can be granted with the CreatePermission operation and revoked with the DeletePermission operation.

" + }, "ListTags":{ "name":"ListTags", "http":{ @@ -231,6 +281,7 @@ {"shape":"ConcurrentModificationException"}, {"shape":"InvalidArnException"}, {"shape":"InvalidStateException"}, + {"shape":"LimitExceededException"}, {"shape":"ResourceNotFoundException"}, {"shape":"RequestAlreadyProcessedException"}, {"shape":"RequestInProgressException"}, @@ -350,6 +401,26 @@ }, "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.

" }, + "AccountId":{ + "type":"string", + "max":12, + "min":12, + "pattern":"[0-9]+" + }, + "ActionList":{ + "type":"list", + "member":{"shape":"ActionType"}, + "max":3, + "min":1 + }, + "ActionType":{ + "type":"string", + "enum":[ + "IssueCertificate", + "GetCertificate", + "ListPermissions" + ] + }, "Arn":{ "type":"string", "max":200, @@ -457,7 +528,7 @@ "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.

" + "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. It also includes the signature algorithm that it uses when issuing certificates, and its X.500 distinguished name. You must specify this information when you call the CreateCertificateAuthority operation.

" }, "CertificateAuthorityStatus":{ "type":"string", @@ -517,15 +588,15 @@ "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 .

" + "documentation":"

The 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.

" + "documentation":"

The 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.

" + "documentation":"

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

" } } }, @@ -564,6 +635,10 @@ "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.

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

Key-value pairs that will be attached to the new private CA. You can associate up to 50 tags with a private CA.

" } } }, @@ -576,6 +651,32 @@ } } }, + "CreatePermissionRequest":{ + "type":"structure", + "required":[ + "CertificateAuthorityArn", + "Principal", + "Actions" + ], + "members":{ + "CertificateAuthorityArn":{ + "shape":"Arn", + "documentation":"

The Amazon Resource Name (ARN) of the CA that grants the permissions. You can find the ARN by calling the ListCertificateAuthorities operation. This must have the following form:

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

" + }, + "Principal":{ + "shape":"Principal", + "documentation":"

The AWS service or identity that receives the permission. At this time, the only valid principal is acm.amazonaws.com.

" + }, + "SourceAccount":{ + "shape":"AccountId", + "documentation":"

The ID of the calling account.

" + }, + "Actions":{ + "shape":"ActionList", + "documentation":"

The actions that the specified AWS service principal can use. These include IssueCertificate, GetCertificate, and ListPermissions.

" + } + } + }, "CrlConfiguration":{ "type":"structure", "required":["Enabled"], @@ -621,6 +722,27 @@ } } }, + "DeletePermissionRequest":{ + "type":"structure", + "required":[ + "CertificateAuthorityArn", + "Principal" + ], + "members":{ + "CertificateAuthorityArn":{ + "shape":"Arn", + "documentation":"

The Amazon Resource Number (ARN) of the private CA that issued the permissions. You can find the CA's ARN by calling the ListCertificateAuthorities operation. This must have the following form:

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

" + }, + "Principal":{ + "shape":"Principal", + "documentation":"

The AWS service or identity that will have its CA permissions revoked. At this time, the only valid service principal is acm.amazonaws.com

" + }, + "SourceAccount":{ + "shape":"AccountId", + "documentation":"

The AWS account that calls this operation.

" + } + } + }, "DescribeCertificateAuthorityAuditReportRequest":{ "type":"structure", "required":[ @@ -834,7 +956,7 @@ "members":{ "message":{"shape":"String"} }, - "documentation":"

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

", + "documentation":"

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

", "exception":true }, "InvalidTagException":{ @@ -928,6 +1050,37 @@ } } }, + "ListPermissionsRequest":{ + "type":"structure", + "required":["CertificateAuthorityArn"], + "members":{ + "CertificateAuthorityArn":{ + "shape":"Arn", + "documentation":"

The Amazon Resource Number (ARN) of the private CA to inspect. You can find the ARN by calling the ListCertificateAuthorities operation. This must be of the form: arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012 You can get a private CA's ARN by running the ListCertificateAuthorities operation.

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

When paginating results, use this parameter 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":"

When paginating results, use this parameter 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.

" + } + } + }, + "ListPermissionsResponse":{ + "type":"structure", + "members":{ + "Permissions":{ + "shape":"PermissionList", + "documentation":"

Summary information about each permission assigned by the specified private CA, including the action enabled, the policy provided, and the time of creation.

" + }, + "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"], @@ -990,10 +1143,59 @@ "max":30, "min":7 }, + "Permission":{ + "type":"structure", + "members":{ + "CertificateAuthorityArn":{ + "shape":"Arn", + "documentation":"

The Amazon Resource Number (ARN) of the private CA from which the permission was issued.

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

The time at which the permission was created.

" + }, + "Principal":{ + "shape":"String", + "documentation":"

The AWS service or entity that holds the permission. At this time, the only valid principal is acm.amazonaws.com.

" + }, + "SourceAccount":{ + "shape":"String", + "documentation":"

The ID of the account that assigned the permission.

" + }, + "Actions":{ + "shape":"ActionList", + "documentation":"

The private CA operations that can be performed by the designated AWS service.

" + }, + "Policy":{ + "shape":"String", + "documentation":"

The name of the policy that is associated with the permission.

" + } + }, + "documentation":"

Permissions designate which private CA operations can be performed by an AWS service or entity. In order for ACM to automatically renew private certificates, you must give the ACM service principal all available permissions (IssueCertificate, GetCertificate, and ListPermissions). Permissions can be assigned with the CreatePermission operation, removed with the DeletePermission operation, and listed with the ListPermissions operation.

" + }, + "PermissionAlreadyExistsException":{ + "type":"structure", + "members":{ + "message":{"shape":"String"} + }, + "documentation":"

The designated permission has already been given to the user.

", + "exception":true + }, + "PermissionList":{ + "type":"list", + "member":{"shape":"Permission"}, + "min":0 + }, "PositiveLong":{ "type":"long", "min":1 }, + "Principal":{ + "type":"string", + "max":128, + "min":0, + "pattern":"^[^*]+$" + }, "RequestAlreadyProcessedException":{ "type":"structure", "members":{ @@ -1170,7 +1372,7 @@ "type":"string", "max":128, "min":1, - "pattern":"[\\p{L}\\p{Z}\\p{N}_.:\\/=+\\-@]*" + "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" }, "TagList":{ "type":"list", @@ -1182,7 +1384,7 @@ "type":"string", "max":256, "min":0, - "pattern":"[\\p{L}\\p{Z}\\p{N}_.:\\/=+\\-@]*" + "pattern":"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" }, "TooManyTagsException":{ "type":"structure", @@ -1257,5 +1459,5 @@ ] } }, - "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.

" + "documentation":"

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

You can also call the CreateCertificateAuthorityAuditReport to create an optional audit report, which enumerates all of the issued, valid, expired, and revoked certificates from the CA.

Each ACM PCA API operation has a throttling limit which determines the number of times the operation can be called per second. For more information, see API Rate Limits in ACM PCA in the ACM PCA user guide.

" } diff --git a/bin/botocore/data/acm-pca/2017-08-22/waiters-2.json b/bin/botocore/data/acm-pca/2017-08-22/waiters-2.json new file mode 100644 index 00000000..79bf399b --- /dev/null +++ b/bin/botocore/data/acm-pca/2017-08-22/waiters-2.json @@ -0,0 +1,61 @@ +{ + "version": 2, + "waiters": { + "CertificateAuthorityCSRCreated": { + "description": "Wait until a Certificate Authority CSR is created", + "operation": "GetCertificateAuthorityCsr", + "delay": 3, + "maxAttempts": 60, + "acceptors": [ + { + "state": "success", + "matcher": "status", + "expected": 200 + }, + { + "state": "retry", + "matcher": "error", + "expected": "RequestInProgressException" + } + ] + }, + "CertificateIssued": { + "description": "Wait until a certificate is issued", + "operation": "GetCertificate", + "delay": 3, + "maxAttempts": 60, + "acceptors": [ + { + "state": "success", + "matcher": "status", + "expected": 200 + }, + { + "state": "retry", + "matcher": "error", + "expected": "RequestInProgressException" + } + ] + }, + "AuditReportCreated": { + "description": "Wait until a Audit Report is created", + "operation": "DescribeCertificateAuthorityAuditReport", + "delay": 3, + "maxAttempts": 60, + "acceptors": [ + { + "state": "success", + "matcher": "path", + "argument": "AuditReportStatus", + "expected": "SUCCESS" + }, + { + "state": "failure", + "matcher": "path", + "argument": "AuditReportStatus", + "expected": "FAILED" + } + ] + } + } +} diff --git a/bin/botocore/data/acm/2015-12-08/service-2.json b/bin/botocore/data/acm/2015-12-08/service-2.json index 5845ed9e..daf9bca9 100644 --- a/bin/botocore/data/acm/2015-12-08/service-2.json +++ b/bin/botocore/data/acm/2015-12-08/service-2.json @@ -26,7 +26,7 @@ {"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.

" + "documentation":"

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", @@ -98,7 +98,7 @@ {"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.

" + "documentation":"

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", @@ -108,6 +108,9 @@ }, "input":{"shape":"ListCertificatesRequest"}, "output":{"shape":"ListCertificatesResponse"}, + "errors":[ + {"shape":"InvalidArgsException"} + ], "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":{ @@ -138,6 +141,19 @@ ], "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.

" }, + "RenewCertificate":{ + "name":"RenewCertificate", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"RenewCertificateRequest"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidArnException"} + ], + "documentation":"

Renews an eligable ACM certificate. At this time, only exported private certificates can be renewed with this operation. In order to renew your ACM PCA certificates with ACM, you must first grant the ACM service principal permission to do so. For more information, see Testing Managed Renewal in the ACM User Guide.

" + }, "RequestCertificate":{ "name":"RequestCertificate", "http":{ @@ -151,7 +167,7 @@ {"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.

" + "documentation":"

" }, "ResendValidationEmail":{ "name":"ResendValidationEmail", @@ -166,7 +182,7 @@ {"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.

" + "documentation":"

" }, "UpdateCertificateOptions":{ "name":"UpdateCertificateOptions", @@ -181,7 +197,7 @@ {"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.

" + "documentation":"

" } }, "shapes":{ @@ -194,7 +210,7 @@ "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.

" + "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", @@ -235,7 +251,7 @@ "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.

" + "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", @@ -307,15 +323,15 @@ }, "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.

" + "documentation":"

" }, "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.

" + "documentation":"

" }, "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.

" + "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", @@ -331,7 +347,7 @@ }, "RenewalEligibility":{ "shape":"RenewalEligibility", - "documentation":"

Specifies whether the certificate is eligible for renewal.

" + "documentation":"

Specifies whether the certificate is eligible for renewal. At this time, only exported private certificates can be renewed with the RenewCertificate command.

" }, "Options":{ "shape":"CertificateOptions", @@ -348,7 +364,7 @@ "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.

" + "documentation":"

" }, "CertificateStatus":{ "type":"string", @@ -371,7 +387,7 @@ "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.

" + "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", @@ -405,7 +421,7 @@ "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.

" + "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.

" } } }, @@ -415,7 +431,7 @@ "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.

" + "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.

" } } }, @@ -470,7 +486,7 @@ }, "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.

" + "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", @@ -539,7 +555,7 @@ }, "PrivateKey":{ "shape":"PrivateKey", - "documentation":"

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

" + "documentation":"

The encrypted private key associated with the public key in the certificate. The key is output in PKCS #8 format and is base64 PEM-encoded.

" } } }, @@ -589,6 +605,7 @@ "ADDITIONAL_VERIFICATION_REQUIRED", "DOMAIN_NOT_ALLOWED", "INVALID_PUBLIC_DOMAIN", + "DOMAIN_VALIDATION_DENIED", "CAA_ERROR", "PCA_LIMIT_EXCEEDED", "PCA_INVALID_ARN", @@ -596,6 +613,8 @@ "PCA_REQUEST_FAILED", "PCA_RESOURCE_NOT_FOUND", "PCA_INVALID_ARGS", + "PCA_INVALID_DURATION", + "PCA_ACCESS_DENIED", "OTHER" ] }, @@ -623,7 +642,7 @@ "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.

" + "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.

" } } }, @@ -655,7 +674,7 @@ "members":{ "CertificateArn":{ "shape":"Arn", - "documentation":"

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

" + "documentation":"

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

" }, "Certificate":{ "shape":"CertificateBodyBlob", @@ -676,7 +695,7 @@ "members":{ "CertificateArn":{ "shape":"Arn", - "documentation":"

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

" + "documentation":"

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

" } } }, @@ -684,6 +703,14 @@ "type":"list", "member":{"shape":"String"} }, + "InvalidArgsException":{ + "type":"structure", + "members":{ + "message":{"shape":"String"} + }, + "documentation":"

One or more of of request parameters specified is not valid.

", + "exception":true + }, "InvalidArnException":{ "type":"structure", "members":{ @@ -813,7 +840,7 @@ "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.

" + "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.

" } } }, @@ -869,7 +896,7 @@ "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.

" + "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", @@ -877,6 +904,16 @@ } } }, + "RenewCertificateRequest":{ + "type":"structure", + "required":["CertificateArn"], + "members":{ + "CertificateArn":{ + "shape":"Arn", + "documentation":"

String that contains the ARN of the ACM certificate to be renewed. 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.

" + } + } + }, "RenewalEligibility":{ "type":"string", "enum":[ @@ -897,19 +934,28 @@ "type":"structure", "required":[ "RenewalStatus", - "DomainValidationOptions" + "DomainValidationOptions", + "UpdatedAt" ], "members":{ "RenewalStatus":{ "shape":"RenewalStatus", - "documentation":"

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

" + "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":"

" + }, + "RenewalStatusReason":{ + "shape":"FailureReason", + "documentation":"

The reason that a renewal request was unsuccessful.

" + }, + "UpdatedAt":{ + "shape":"TStamp", + "documentation":"

The time at which the renewal summary was last updated.

" } }, - "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.

" + "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", @@ -921,11 +967,11 @@ }, "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.

" + "documentation":"

" }, "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.

" + "documentation":"

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", @@ -937,11 +983,11 @@ }, "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.

" + "documentation":"

" }, "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

" + "documentation":"

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

" } } }, @@ -1110,5 +1156,5 @@ ] } }, - "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 .

" + "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/bin/botocore/data/alexaforbusiness/2017-11-09/paginators-1.json b/bin/botocore/data/alexaforbusiness/2017-11-09/paginators-1.json index a91b700d..ced5de2f 100644 --- a/bin/botocore/data/alexaforbusiness/2017-11-09/paginators-1.json +++ b/bin/botocore/data/alexaforbusiness/2017-11-09/paginators-1.json @@ -41,6 +41,42 @@ "output_token": "NextToken", "input_token": "NextToken", "limit_key": "MaxResults" + }, + "ListBusinessReportSchedules": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "BusinessReportSchedules" + }, + "ListConferenceProviders": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "ConferenceProviders" + }, + "ListDeviceEvents": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "DeviceEvents" + }, + "ListSkillsStoreCategories": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "CategoryList" + }, + "ListSkillsStoreSkillsByCategory": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "SkillsStoreSkills" + }, + "ListSmartHomeAppliances": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "SmartHomeAppliances" } } } diff --git a/bin/botocore/data/alexaforbusiness/2017-11-09/service-2.json b/bin/botocore/data/alexaforbusiness/2017-11-09/service-2.json index c452c78f..f0240082 100644 --- a/bin/botocore/data/alexaforbusiness/2017-11-09/service-2.json +++ b/bin/botocore/data/alexaforbusiness/2017-11-09/service-2.json @@ -40,6 +40,21 @@ ], "documentation":"

Associates a contact with a given address book.

" }, + "AssociateDeviceWithNetworkProfile":{ + "name":"AssociateDeviceWithNetworkProfile", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"AssociateDeviceWithNetworkProfileRequest"}, + "output":{"shape":"AssociateDeviceWithNetworkProfileResponse"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"ConcurrentModificationException"}, + {"shape":"DeviceNotRegisteredException"} + ], + "documentation":"

Associates a device with the specified network profile.

" + }, "AssociateDeviceWithRoom":{ "name":"AssociateDeviceWithRoom", "http":{ @@ -78,10 +93,25 @@ "output":{"shape":"AssociateSkillWithSkillGroupResponse"}, "errors":[ {"shape":"ConcurrentModificationException"}, - {"shape":"NotFoundException"} + {"shape":"NotFoundException"}, + {"shape":"SkillNotLinkedException"} ], "documentation":"

Associates a skill with a skill group.

" }, + "AssociateSkillWithUsers":{ + "name":"AssociateSkillWithUsers", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"AssociateSkillWithUsersRequest"}, + "output":{"shape":"AssociateSkillWithUsersResponse"}, + "errors":[ + {"shape":"ConcurrentModificationException"}, + {"shape":"NotFoundException"} + ], + "documentation":"

Makes a private skill available for enrolled users to enable on their devices.

" + }, "CreateAddressBook":{ "name":"CreateAddressBook", "http":{ @@ -96,6 +126,19 @@ ], "documentation":"

Creates an address book with the specified details.

" }, + "CreateBusinessReportSchedule":{ + "name":"CreateBusinessReportSchedule", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateBusinessReportScheduleRequest"}, + "output":{"shape":"CreateBusinessReportScheduleResponse"}, + "errors":[ + {"shape":"AlreadyExistsException"} + ], + "documentation":"

Creates a recurring schedule for usage reports to deliver to the specified S3 location with a specified daily or weekly interval.

" + }, "CreateConferenceProvider":{ "name":"CreateConferenceProvider", "http":{ @@ -123,6 +166,37 @@ ], "documentation":"

Creates a contact with the specified details.

" }, + "CreateGatewayGroup":{ + "name":"CreateGatewayGroup", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateGatewayGroupRequest"}, + "output":{"shape":"CreateGatewayGroupResponse"}, + "errors":[ + {"shape":"AlreadyExistsException"}, + {"shape":"LimitExceededException"} + ], + "documentation":"

Creates a gateway group with the specified details.

" + }, + "CreateNetworkProfile":{ + "name":"CreateNetworkProfile", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateNetworkProfileRequest"}, + "output":{"shape":"CreateNetworkProfileResponse"}, + "errors":[ + {"shape":"AlreadyExistsException"}, + {"shape":"LimitExceededException"}, + {"shape":"ConcurrentModificationException"}, + {"shape":"InvalidCertificateAuthorityException"}, + {"shape":"InvalidServiceLinkedRoleStateException"} + ], + "documentation":"

Creates a network profile with the specified details.

" + }, "CreateProfile":{ "name":"CreateProfile", "http":{ @@ -196,6 +270,20 @@ ], "documentation":"

Deletes an address book by the address book ARN.

" }, + "DeleteBusinessReportSchedule":{ + "name":"DeleteBusinessReportSchedule", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteBusinessReportScheduleRequest"}, + "output":{"shape":"DeleteBusinessReportScheduleResponse"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"ConcurrentModificationException"} + ], + "documentation":"

Deletes the recurring report delivery schedule with the specified schedule ARN.

" + }, "DeleteConferenceProvider":{ "name":"DeleteConferenceProvider", "http":{ @@ -238,6 +326,49 @@ ], "documentation":"

Removes a device from Alexa For Business.

" }, + "DeleteDeviceUsageData":{ + "name":"DeleteDeviceUsageData", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteDeviceUsageDataRequest"}, + "output":{"shape":"DeleteDeviceUsageDataResponse"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"DeviceNotRegisteredException"}, + {"shape":"LimitExceededException"} + ], + "documentation":"

When this action is called for a specified shared device, it allows authorized users to delete the device's entire previous history of voice input data. This action can be called once every 24 hours for a specific shared device.

" + }, + "DeleteGatewayGroup":{ + "name":"DeleteGatewayGroup", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteGatewayGroupRequest"}, + "output":{"shape":"DeleteGatewayGroupResponse"}, + "errors":[ + {"shape":"ResourceAssociatedException"} + ], + "documentation":"

Deletes a gateway group.

" + }, + "DeleteNetworkProfile":{ + "name":"DeleteNetworkProfile", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteNetworkProfileRequest"}, + "output":{"shape":"DeleteNetworkProfileResponse"}, + "errors":[ + {"shape":"ResourceInUseException"}, + {"shape":"ConcurrentModificationException"}, + {"shape":"NotFoundException"} + ], + "documentation":"

Deletes a network profile by the network profile ARN.

" + }, "DeleteProfile":{ "name":"DeleteProfile", "http":{ @@ -359,6 +490,20 @@ ], "documentation":"

Disassociates a skill from a skill group.

" }, + "DisassociateSkillFromUsers":{ + "name":"DisassociateSkillFromUsers", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DisassociateSkillFromUsersRequest"}, + "output":{"shape":"DisassociateSkillFromUsersResponse"}, + "errors":[ + {"shape":"ConcurrentModificationException"}, + {"shape":"NotFoundException"} + ], + "documentation":"

Makes a private skill unavailable for enrolled users and prevents them from enabling it on their devices.

" + }, "DisassociateSkillGroupFromRoom":{ "name":"DisassociateSkillGroupFromRoom", "http":{ @@ -450,6 +595,59 @@ ], "documentation":"

Gets the details of a device by device ARN.

" }, + "GetGateway":{ + "name":"GetGateway", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetGatewayRequest"}, + "output":{"shape":"GetGatewayResponse"}, + "errors":[ + {"shape":"NotFoundException"} + ], + "documentation":"

Retrieves the details of a gateway.

" + }, + "GetGatewayGroup":{ + "name":"GetGatewayGroup", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetGatewayGroupRequest"}, + "output":{"shape":"GetGatewayGroupResponse"}, + "errors":[ + {"shape":"NotFoundException"} + ], + "documentation":"

Retrieves the details of a gateway group.

" + }, + "GetInvitationConfiguration":{ + "name":"GetInvitationConfiguration", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetInvitationConfigurationRequest"}, + "output":{"shape":"GetInvitationConfigurationResponse"}, + "errors":[ + {"shape":"NotFoundException"} + ], + "documentation":"

Retrieves the configured values for the user enrollment invitation email template.

" + }, + "GetNetworkProfile":{ + "name":"GetNetworkProfile", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetNetworkProfileRequest"}, + "output":{"shape":"GetNetworkProfileResponse"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"InvalidSecretsManagerResourceException"} + ], + "documentation":"

Gets the network profile details by the network profile ARN.

" + }, "GetProfile":{ "name":"GetProfile", "http":{ @@ -502,6 +700,16 @@ ], "documentation":"

Gets skill group details by skill group ARN.

" }, + "ListBusinessReportSchedules":{ + "name":"ListBusinessReportSchedules", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListBusinessReportSchedulesRequest"}, + "output":{"shape":"ListBusinessReportSchedulesResponse"}, + "documentation":"

Lists the details of the schedules that a user configured.

" + }, "ListConferenceProviders":{ "name":"ListConferenceProviders", "http":{ @@ -525,6 +733,26 @@ ], "documentation":"

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

" }, + "ListGatewayGroups":{ + "name":"ListGatewayGroups", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListGatewayGroupsRequest"}, + "output":{"shape":"ListGatewayGroupsResponse"}, + "documentation":"

Retrieves a list of gateway group summaries. Use GetGatewayGroup to retrieve details of a specific gateway group.

" + }, + "ListGateways":{ + "name":"ListGateways", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListGatewaysRequest"}, + "output":{"shape":"ListGatewaysResponse"}, + "documentation":"

Retrieves a list of gateway summaries. Use GetGateway to retrieve details of a specific gateway. An optional gateway group ARN can be provided to only retrieve gateway summaries of gateways that are associated with that gateway group ARN.

" + }, "ListSkills":{ "name":"ListSkills", "http":{ @@ -594,6 +822,20 @@ ], "documentation":"

Sets the conference preferences on a specific conference provider at the account level.

" }, + "PutInvitationConfiguration":{ + "name":"PutInvitationConfiguration", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"PutInvitationConfigurationRequest"}, + "output":{"shape":"PutInvitationConfigurationResponse"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"ConcurrentModificationException"} + ], + "documentation":"

Configures the email template for the user enrollment invitation with the specified attributes.

" + }, "PutRoomSkillParameter":{ "name":"PutRoomSkillParameter", "http":{ @@ -707,6 +949,16 @@ "output":{"shape":"SearchDevicesResponse"}, "documentation":"

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

" }, + "SearchNetworkProfiles":{ + "name":"SearchNetworkProfiles", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"SearchNetworkProfilesRequest"}, + "output":{"shape":"SearchNetworkProfilesResponse"}, + "documentation":"

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

" + }, "SearchProfiles":{ "name":"SearchProfiles", "http":{ @@ -747,6 +999,20 @@ "output":{"shape":"SearchUsersResponse"}, "documentation":"

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

" }, + "SendAnnouncement":{ + "name":"SendAnnouncement", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"SendAnnouncementRequest"}, + "output":{"shape":"SendAnnouncementResponse"}, + "errors":[ + {"shape":"LimitExceededException"}, + {"shape":"AlreadyExistsException"} + ], + "documentation":"

Triggers an asynchronous flow to send text, SSML, or audio announcements to rooms that are identified by a search or filter.

" + }, "SendInvitation":{ "name":"SendInvitation", "http":{ @@ -773,7 +1039,7 @@ "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.

" + "documentation":"

Resets a device and its account to the known default settings. This clears all information and settings set by previous users in the following ways:

Bluetooth - This unpairs all bluetooth devices paired with your echo device.
Volume - This resets the echo device's volume to the default value.
Notifications - This clears all notifications from your echo device.
Lists - This clears all to-do items from your echo device.
Settings - This internally syncs the room's profile (if the device is assigned to a room), contacts, address books, delegation access for account linking, and communications (if enabled on the room profile).

" }, "StartSmartHomeApplianceDiscovery":{ "name":"StartSmartHomeApplianceDiscovery", @@ -829,6 +1095,20 @@ ], "documentation":"

Updates address book details by the address book ARN.

" }, + "UpdateBusinessReportSchedule":{ + "name":"UpdateBusinessReportSchedule", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UpdateBusinessReportScheduleRequest"}, + "output":{"shape":"UpdateBusinessReportScheduleResponse"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"ConcurrentModificationException"} + ], + "documentation":"

Updates the configuration of the report delivery schedule with the specified schedule ARN.

" + }, "UpdateConferenceProvider":{ "name":"UpdateConferenceProvider", "http":{ @@ -871,6 +1151,51 @@ ], "documentation":"

Updates the device name by device ARN.

" }, + "UpdateGateway":{ + "name":"UpdateGateway", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UpdateGatewayRequest"}, + "output":{"shape":"UpdateGatewayResponse"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"NameInUseException"} + ], + "documentation":"

Updates the details of a gateway. If any optional field is not provided, the existing corresponding value is left unmodified.

" + }, + "UpdateGatewayGroup":{ + "name":"UpdateGatewayGroup", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UpdateGatewayGroupRequest"}, + "output":{"shape":"UpdateGatewayGroupResponse"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"NameInUseException"} + ], + "documentation":"

Updates the details of a gateway group. If any optional field is not provided, the existing corresponding value is left unmodified.

" + }, + "UpdateNetworkProfile":{ + "name":"UpdateNetworkProfile", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UpdateNetworkProfileRequest"}, + "output":{"shape":"UpdateNetworkProfileResponse"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"NameInUseException"}, + {"shape":"ConcurrentModificationException"}, + {"shape":"InvalidCertificateAuthorityException"}, + {"shape":"InvalidSecretsManagerResourceException"} + ], + "documentation":"

Updates a network profile by the network profile ARN.

" + }, "UpdateProfile":{ "name":"UpdateProfile", "http":{ @@ -1030,6 +1355,28 @@ "members":{ } }, + "AssociateDeviceWithNetworkProfileRequest":{ + "type":"structure", + "required":[ + "DeviceArn", + "NetworkProfileArn" + ], + "members":{ + "DeviceArn":{ + "shape":"Arn", + "documentation":"

The device ARN.

" + }, + "NetworkProfileArn":{ + "shape":"Arn", + "documentation":"

The ARN of the network profile to associate with a device.

" + } + } + }, + "AssociateDeviceWithNetworkProfileResponse":{ + "type":"structure", + "members":{ + } + }, "AssociateDeviceWithRoomRequest":{ "type":"structure", "members":{ @@ -1085,6 +1432,50 @@ "members":{ } }, + "AssociateSkillWithUsersRequest":{ + "type":"structure", + "required":["SkillId"], + "members":{ + "SkillId":{ + "shape":"SkillId", + "documentation":"

The private skill ID you want to make available to enrolled users.

" + } + } + }, + "AssociateSkillWithUsersResponse":{ + "type":"structure", + "members":{ + } + }, + "Audio":{ + "type":"structure", + "required":[ + "Locale", + "Location" + ], + "members":{ + "Locale":{ + "shape":"Locale", + "documentation":"

The locale of the audio message. Currently, en-US is supported.

" + }, + "Location":{ + "shape":"AudioLocation", + "documentation":"

The location of the audio file. Currently, S3 URLs are supported. Only S3 locations comprised of safe characters are valid. For more information, see Safe Characters.

" + } + }, + "documentation":"

The audio message. There is a 1 MB limit on the audio file input and the only supported format is MP3. To convert your MP3 audio files to an Alexa-friendly,

required codec version (MPEG version 2) and bit rate (48 kbps), you might use converter software. One option for this is a command-line tool, FFmpeg. For more information, see FFmpeg. The following command converts the provided <input-file> to an MP3 file that is played in the announcement:

ffmpeg -i <input-file> -ac 2 -codec:a libmp3lame -b:a 48k -ar 16000 <output-file.mp3>

" + }, + "AudioList":{ + "type":"list", + "member":{"shape":"Audio"}, + "max":1 + }, + "AudioLocation":{ + "type":"string", + "max":1200, + "min":0, + "pattern":"https://([A-Za-z0-9_.-]+)?(s3-[A-Za-z0-9-]+|s3\\.([A-Za-z0-9-])+|s3|s3.dualstack\\.([A-Za-z0-9-])+)+.amazonaws.com/.*" + }, "AuthorizationResult":{ "type":"map", "key":{"shape":"Key"}, @@ -1097,36 +1488,178 @@ "type":"list", "member":{"shape":"BulletPoint"} }, - "Category":{ + "BusinessReport":{ "type":"structure", "members":{ - "CategoryId":{ - "shape":"CategoryId", - "documentation":"

The ID of the skill store category.

" + "Status":{ + "shape":"BusinessReportStatus", + "documentation":"

The status of the report generation execution (RUNNING, SUCCEEDED, or FAILED).

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

The name of the skill store category.

" + "FailureCode":{ + "shape":"BusinessReportFailureCode", + "documentation":"

The failure code.

" + }, + "S3Location":{ + "shape":"BusinessReportS3Location", + "documentation":"

The S3 location of the output reports.

" + }, + "DeliveryTime":{ + "shape":"BusinessReportDeliveryTime", + "documentation":"

The time of report delivery.

" + }, + "DownloadUrl":{ + "shape":"BusinessReportDownloadUrl", + "documentation":"

The download link where a user can download the report.

" } }, - "documentation":"

The skill store category that is shown. Alexa skills are assigned a specific skill category during creation, such as News, Social, and Sports.

" - }, - "CategoryId":{ - "type":"long", - "min":1 + "documentation":"

Usage report with specified parameters.

" }, - "CategoryList":{ - "type":"list", + "BusinessReportContentRange":{ + "type":"structure", + "members":{ + "Interval":{ + "shape":"BusinessReportInterval", + "documentation":"

The interval of the content range.

" + } + }, + "documentation":"

The content range of the report.

" + }, + "BusinessReportDeliveryTime":{"type":"timestamp"}, + "BusinessReportDownloadUrl":{"type":"string"}, + "BusinessReportFailureCode":{ + "type":"string", + "enum":[ + "ACCESS_DENIED", + "NO_SUCH_BUCKET", + "INTERNAL_FAILURE" + ] + }, + "BusinessReportFormat":{ + "type":"string", + "enum":[ + "CSV", + "CSV_ZIP" + ] + }, + "BusinessReportInterval":{ + "type":"string", + "enum":[ + "ONE_DAY", + "ONE_WEEK" + ] + }, + "BusinessReportRecurrence":{ + "type":"structure", + "members":{ + "StartDate":{ + "shape":"Date", + "documentation":"

The start date.

" + } + }, + "documentation":"

The recurrence of the reports.

" + }, + "BusinessReportS3Location":{ + "type":"structure", + "members":{ + "Path":{ + "shape":"BusinessReportS3Path", + "documentation":"

The path of the business report.

" + }, + "BucketName":{ + "shape":"CustomerS3BucketName", + "documentation":"

The S3 bucket name of the output reports.

" + } + }, + "documentation":"

The S3 location of the output reports.

" + }, + "BusinessReportS3Path":{"type":"string"}, + "BusinessReportSchedule":{ + "type":"structure", + "members":{ + "ScheduleArn":{ + "shape":"Arn", + "documentation":"

The ARN of the business report schedule.

" + }, + "ScheduleName":{ + "shape":"BusinessReportScheduleName", + "documentation":"

The name identifier of the schedule.

" + }, + "S3BucketName":{ + "shape":"CustomerS3BucketName", + "documentation":"

The S3 bucket name of the output reports.

" + }, + "S3KeyPrefix":{ + "shape":"S3KeyPrefix", + "documentation":"

The S3 key where the report is delivered.

" + }, + "Format":{ + "shape":"BusinessReportFormat", + "documentation":"

The format of the generated report (individual CSV files or zipped files of individual files).

" + }, + "ContentRange":{ + "shape":"BusinessReportContentRange", + "documentation":"

The content range of the reports.

" + }, + "Recurrence":{ + "shape":"BusinessReportRecurrence", + "documentation":"

The recurrence of the reports.

" + }, + "LastBusinessReport":{ + "shape":"BusinessReport", + "documentation":"

The details of the last business report delivery for a specified time interval.

" + } + }, + "documentation":"

The schedule of the usage report.

" + }, + "BusinessReportScheduleList":{ + "type":"list", + "member":{"shape":"BusinessReportSchedule"} + }, + "BusinessReportScheduleName":{ + "type":"string", + "max":64, + "min":0, + "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" + }, + "BusinessReportStatus":{ + "type":"string", + "enum":[ + "RUNNING", + "SUCCEEDED", + "FAILED" + ] + }, + "Category":{ + "type":"structure", + "members":{ + "CategoryId":{ + "shape":"CategoryId", + "documentation":"

The ID of the skill store category.

" + }, + "CategoryName":{ + "shape":"CategoryName", + "documentation":"

The name of the skill store category.

" + } + }, + "documentation":"

The skill store category that is shown. Alexa skills are assigned a specific skill category during creation, such as News, Social, and Sports.

" + }, + "CategoryId":{ + "type":"long", + "min":1 + }, + "CategoryList":{ + "type":"list", "member":{"shape":"Category"} }, "CategoryName":{"type":"string"}, + "CertificateTime":{"type":"timestamp"}, "ClientId":{ "type":"string", "pattern":"^\\S+{1,256}$" }, "ClientRequestToken":{ "type":"string", - "documentation":"User specified token that is used to support idempotency during Create Resource", + "documentation":"

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

", "max":150, "min":10, "pattern":"[a-zA-Z0-9][a-zA-Z0-9_-]*" @@ -1144,7 +1677,7 @@ "members":{ "Message":{"shape":"ErrorMessage"} }, - "documentation":"Concurrent modification of resources. HTTP Status Code: 400.", + "documentation":"

There is a concurrent modification of resources.

", "exception":true }, "ConferencePreference":{ @@ -1281,6 +1814,24 @@ "min":1, "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" }, + "Content":{ + "type":"structure", + "members":{ + "TextList":{ + "shape":"TextList", + "documentation":"

The list of text messages.

" + }, + "SsmlList":{ + "shape":"SsmlList", + "documentation":"

The list of SSML messages.

" + }, + "AudioList":{ + "shape":"AudioList", + "documentation":"

The list of audio messages.

" + } + }, + "documentation":"

The content definition. This can contain only one text, SSML, or audio list object.

" + }, "CountryCode":{ "type":"string", "pattern":"\\d{1,3}" @@ -1313,6 +1864,53 @@ } } }, + "CreateBusinessReportScheduleRequest":{ + "type":"structure", + "required":[ + "Format", + "ContentRange" + ], + "members":{ + "ScheduleName":{ + "shape":"BusinessReportScheduleName", + "documentation":"

The name identifier of the schedule.

" + }, + "S3BucketName":{ + "shape":"CustomerS3BucketName", + "documentation":"

The S3 bucket name of the output reports. If this isn't specified, the report can be retrieved from a download link by calling ListBusinessReportSchedule.

" + }, + "S3KeyPrefix":{ + "shape":"S3KeyPrefix", + "documentation":"

The S3 key where the report is delivered.

" + }, + "Format":{ + "shape":"BusinessReportFormat", + "documentation":"

The format of the generated report (individual CSV files or zipped files of individual files).

" + }, + "ContentRange":{ + "shape":"BusinessReportContentRange", + "documentation":"

The content range of the reports.

" + }, + "Recurrence":{ + "shape":"BusinessReportRecurrence", + "documentation":"

The recurrence of the reports. If this isn't specified, the report will only be delivered one time when the API is called.

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

The client request token.

", + "idempotencyToken":true + } + } + }, + "CreateBusinessReportScheduleResponse":{ + "type":"structure", + "members":{ + "ScheduleArn":{ + "shape":"Arn", + "documentation":"

The ARN of the business report schedule.

" + } + } + }, "CreateConferenceProviderRequest":{ "type":"structure", "required":[ @@ -1359,10 +1957,7 @@ }, "CreateContactRequest":{ "type":"structure", - "required":[ - "FirstName", - "PhoneNumber" - ], + "required":["FirstName"], "members":{ "DisplayName":{ "shape":"ContactName", @@ -1396,6 +1991,97 @@ } } }, + "CreateGatewayGroupRequest":{ + "type":"structure", + "required":[ + "Name", + "ClientRequestToken" + ], + "members":{ + "Name":{ + "shape":"GatewayGroupName", + "documentation":"

The name of the gateway group.

" + }, + "Description":{ + "shape":"GatewayGroupDescription", + "documentation":"

The description of the gateway group.

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

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

", + "idempotencyToken":true + } + } + }, + "CreateGatewayGroupResponse":{ + "type":"structure", + "members":{ + "GatewayGroupArn":{ + "shape":"Arn", + "documentation":"

The ARN of the created gateway group.

" + } + } + }, + "CreateNetworkProfileRequest":{ + "type":"structure", + "required":[ + "NetworkProfileName", + "Ssid", + "SecurityType", + "ClientRequestToken" + ], + "members":{ + "NetworkProfileName":{ + "shape":"NetworkProfileName", + "documentation":"

The name of the network profile associated with a device.

" + }, + "Description":{ + "shape":"NetworkProfileDescription", + "documentation":"

Detailed information about a device's network profile.

" + }, + "Ssid":{ + "shape":"NetworkSsid", + "documentation":"

The SSID of the Wi-Fi network.

" + }, + "SecurityType":{ + "shape":"NetworkSecurityType", + "documentation":"

The security type of the Wi-Fi network. This can be WPA2_ENTERPRISE, WPA2_PSK, WPA_PSK, WEP, or OPEN.

" + }, + "EapMethod":{ + "shape":"NetworkEapMethod", + "documentation":"

The authentication standard that is used in the EAP framework. Currently, EAP_TLS is supported.

" + }, + "CurrentPassword":{ + "shape":"CurrentWiFiPassword", + "documentation":"

The current password of the Wi-Fi network.

" + }, + "NextPassword":{ + "shape":"NextWiFiPassword", + "documentation":"

The next, or subsequent, password of the Wi-Fi network. This password is asynchronously transmitted to the device and is used when the password of the network changes to NextPassword.

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

The ARN of the Private Certificate Authority (PCA) created in AWS Certificate Manager (ACM). This is used to issue certificates to the devices.

" + }, + "TrustAnchors":{ + "shape":"TrustAnchorList", + "documentation":"

The root certificates of your authentication server that is installed on your devices and used to trust your authentication server during EAP negotiation.

" + }, + "ClientRequestToken":{ + "shape":"ClientRequestToken", + "idempotencyToken":true + } + } + }, + "CreateNetworkProfileResponse":{ + "type":"structure", + "members":{ + "NetworkProfileArn":{ + "shape":"Arn", + "documentation":"

The ARN of the network profile associated with a device.

" + } + } + }, "CreateProfileRequest":{ "type":"structure", "required":[ @@ -1567,6 +2253,21 @@ } } }, + "CurrentWiFiPassword":{ + "type":"string", + "max":128, + "min":5, + "pattern":"[\\x00-\\x7F]*", + "sensitive":true + }, + "CustomerS3BucketName":{ + "type":"string", + "pattern":"[a-z0-9-\\.]{3,63}" + }, + "Date":{ + "type":"string", + "pattern":"^\\d{4}\\-(0?[1-9]|1[012])\\-(0?[1-9]|[12][0-9]|3[01])$" + }, "DeleteAddressBookRequest":{ "type":"structure", "required":["AddressBookArn"], @@ -1582,6 +2283,21 @@ "members":{ } }, + "DeleteBusinessReportScheduleRequest":{ + "type":"structure", + "required":["ScheduleArn"], + "members":{ + "ScheduleArn":{ + "shape":"Arn", + "documentation":"

The ARN of the business report schedule.

" + } + } + }, + "DeleteBusinessReportScheduleResponse":{ + "type":"structure", + "members":{ + } + }, "DeleteConferenceProviderRequest":{ "type":"structure", "required":["ConferenceProviderArn"], @@ -1627,6 +2343,58 @@ "members":{ } }, + "DeleteDeviceUsageDataRequest":{ + "type":"structure", + "required":[ + "DeviceArn", + "DeviceUsageType" + ], + "members":{ + "DeviceArn":{ + "shape":"Arn", + "documentation":"

The ARN of the device.

" + }, + "DeviceUsageType":{ + "shape":"DeviceUsageType", + "documentation":"

The type of usage data to delete.

" + } + } + }, + "DeleteDeviceUsageDataResponse":{ + "type":"structure", + "members":{ + } + }, + "DeleteGatewayGroupRequest":{ + "type":"structure", + "required":["GatewayGroupArn"], + "members":{ + "GatewayGroupArn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway group to delete.

" + } + } + }, + "DeleteGatewayGroupResponse":{ + "type":"structure", + "members":{ + } + }, + "DeleteNetworkProfileRequest":{ + "type":"structure", + "required":["NetworkProfileArn"], + "members":{ + "NetworkProfileArn":{ + "shape":"Arn", + "documentation":"

The ARN of the network profile associated with a device.

" + } + } + }, + "DeleteNetworkProfileResponse":{ + "type":"structure", + "members":{ + } + }, "DeleteProfileRequest":{ "type":"structure", "members":{ @@ -1794,6 +2562,10 @@ "DeviceStatusInfo":{ "shape":"DeviceStatusInfo", "documentation":"

Detailed information about a device's status.

" + }, + "NetworkProfileInfo":{ + "shape":"DeviceNetworkProfileInfo", + "documentation":"

Detailed information about a device's network profile.

" } }, "documentation":"

A device with attributes.

" @@ -1829,6 +2601,14 @@ "shape":"DeviceStatus", "documentation":"

The status of a device.

" }, + "NetworkProfileArn":{ + "shape":"Arn", + "documentation":"

The ARN of the network profile associated with a device.

" + }, + "NetworkProfileName":{ + "shape":"NetworkProfileName", + "documentation":"

The name of the network profile associated with a device.

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

The room ARN associated with a device.

" @@ -1860,7 +2640,7 @@ "documentation":"

The value of the event.

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

The time (in epoch) when the event occurred.

" } }, @@ -1870,6 +2650,7 @@ "type":"list", "member":{"shape":"DeviceEvent"} }, + "DeviceEventTime":{"type":"timestamp"}, "DeviceEventType":{ "type":"string", "enum":[ @@ -1884,6 +2665,24 @@ "min":2, "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" }, + "DeviceNetworkProfileInfo":{ + "type":"structure", + "members":{ + "NetworkProfileArn":{ + "shape":"Arn", + "documentation":"

The ARN of the network profile associated with a device.

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

The ARN of the certificate associated with a device.

" + }, + "CertificateExpirationTime":{ + "shape":"CertificateTime", + "documentation":"

The time (in epoch) when the certificate expires.

" + } + }, + "documentation":"

Detailed information about a device's network profile.

" + }, "DeviceNotRegisteredException":{ "type":"structure", "members":{ @@ -1906,12 +2705,17 @@ "READY", "PENDING", "WAS_OFFLINE", - "DEREGISTERED" + "DEREGISTERED", + "FAILED" ] }, "DeviceStatusDetail":{ "type":"structure", "members":{ + "Feature":{ + "shape":"Feature", + "documentation":"

The list of available features on the device.

" + }, "Code":{ "shape":"DeviceStatusDetailCode", "documentation":"

The device status detail code.

" @@ -1923,7 +2727,20 @@ "type":"string", "enum":[ "DEVICE_SOFTWARE_UPDATE_NEEDED", - "DEVICE_WAS_OFFLINE" + "DEVICE_WAS_OFFLINE", + "CREDENTIALS_ACCESS_FAILURE", + "TLS_VERSION_MISMATCH", + "ASSOCIATION_REJECTION", + "AUTHENTICATION_FAILURE", + "DHCP_FAILURE", + "INTERNET_UNAVAILABLE", + "DNS_FAILURE", + "UNKNOWN_FAILURE", + "CERTIFICATE_ISSUING_LIMIT_EXCEEDED", + "INVALID_CERTIFICATE_AUTHORITY", + "NETWORK_PROFILE_NOT_FOUND", + "INVALID_PASSWORD_STATE", + "PASSWORD_NOT_FOUND" ] }, "DeviceStatusDetails":{ @@ -1948,6 +2765,10 @@ "type":"string", "pattern":"[a-zA-Z0-9]{1,200}" }, + "DeviceUsageType":{ + "type":"string", + "enum":["VOICE"] + }, "DisassociateContactFromAddressBookRequest":{ "type":"structure", "required":[ @@ -2003,6 +2824,21 @@ "members":{ } }, + "DisassociateSkillFromUsersRequest":{ + "type":"structure", + "required":["SkillId"], + "members":{ + "SkillId":{ + "shape":"SkillId", + "documentation":"

The private skill ID you want to make unavailable for enrolled users.

" + } + } + }, + "DisassociateSkillFromUsersResponse":{ + "type":"structure", + "members":{ + } + }, "DisassociateSkillGroupFromRoomRequest":{ "type":"structure", "members":{ @@ -2030,7 +2866,8 @@ }, "E164PhoneNumber":{ "type":"string", - "pattern":"^\\+\\d{8,}$" + "pattern":"^\\+\\d{8,}$", + "sensitive":true }, "Email":{ "type":"string", @@ -2082,6 +2919,8 @@ "NOTIFICATIONS", "LISTS", "SKILLS", + "NETWORK_PROFILE", + "SETTINGS", "ALL" ] }, @@ -2125,7 +2964,7 @@ "FilterValueList":{ "type":"list", "member":{"shape":"FilterValue"}, - "max":5 + "max":50 }, "ForgetSmartHomeAppliancesRequest":{ "type":"structure", @@ -2142,6 +2981,130 @@ "members":{ } }, + "Gateway":{ + "type":"structure", + "members":{ + "Arn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway.

" + }, + "Name":{ + "shape":"GatewayName", + "documentation":"

The name of the gateway.

" + }, + "Description":{ + "shape":"GatewayDescription", + "documentation":"

The description of the gateway.

" + }, + "GatewayGroupArn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway group that the gateway is associated to.

" + }, + "SoftwareVersion":{ + "shape":"GatewayVersion", + "documentation":"

The software version of the gateway. The gateway automatically updates its software version during normal operation.

" + } + }, + "documentation":"

The details of the gateway.

" + }, + "GatewayDescription":{ + "type":"string", + "max":200, + "min":0, + "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" + }, + "GatewayGroup":{ + "type":"structure", + "members":{ + "Arn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway group.

" + }, + "Name":{ + "shape":"GatewayGroupName", + "documentation":"

The name of the gateway group.

" + }, + "Description":{ + "shape":"GatewayGroupDescription", + "documentation":"

The description of the gateway group.

" + } + }, + "documentation":"

The details of the gateway group.

" + }, + "GatewayGroupDescription":{ + "type":"string", + "max":200, + "min":0 + }, + "GatewayGroupName":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" + }, + "GatewayGroupSummaries":{ + "type":"list", + "member":{"shape":"GatewayGroupSummary"} + }, + "GatewayGroupSummary":{ + "type":"structure", + "members":{ + "Arn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway group.

" + }, + "Name":{ + "shape":"GatewayGroupName", + "documentation":"

The name of the gateway group.

" + }, + "Description":{ + "shape":"GatewayGroupDescription", + "documentation":"

The description of the gateway group.

" + } + }, + "documentation":"

The summary of a gateway group.

" + }, + "GatewayName":{ + "type":"string", + "max":253, + "min":1, + "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" + }, + "GatewaySummaries":{ + "type":"list", + "member":{"shape":"GatewaySummary"} + }, + "GatewaySummary":{ + "type":"structure", + "members":{ + "Arn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway.

" + }, + "Name":{ + "shape":"GatewayName", + "documentation":"

The name of the gateway.

" + }, + "Description":{ + "shape":"GatewayDescription", + "documentation":"

The description of the gateway.

" + }, + "GatewayGroupArn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway group that the gateway is associated to.

" + }, + "SoftwareVersion":{ + "shape":"GatewayVersion", + "documentation":"

The software version of the gateway. The gateway automatically updates its software version during normal operation.

" + } + }, + "documentation":"

The summary of a gateway.

" + }, + "GatewayVersion":{ + "type":"string", + "max":50, + "min":1 + }, "GenericKeyword":{"type":"string"}, "GenericKeywords":{ "type":"list", @@ -2236,6 +3199,82 @@ } } }, + "GetGatewayGroupRequest":{ + "type":"structure", + "required":["GatewayGroupArn"], + "members":{ + "GatewayGroupArn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway group to get.

" + } + } + }, + "GetGatewayGroupResponse":{ + "type":"structure", + "members":{ + "GatewayGroup":{"shape":"GatewayGroup"} + } + }, + "GetGatewayRequest":{ + "type":"structure", + "required":["GatewayArn"], + "members":{ + "GatewayArn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway to get.

" + } + } + }, + "GetGatewayResponse":{ + "type":"structure", + "members":{ + "Gateway":{ + "shape":"Gateway", + "documentation":"

The details of the gateway.

" + } + } + }, + "GetInvitationConfigurationRequest":{ + "type":"structure", + "members":{ + } + }, + "GetInvitationConfigurationResponse":{ + "type":"structure", + "members":{ + "OrganizationName":{ + "shape":"OrganizationName", + "documentation":"

The name of the organization sending the enrollment invite to a user.

" + }, + "ContactEmail":{ + "shape":"Email", + "documentation":"

The email ID of the organization or individual contact that the enrolled user can use.

" + }, + "PrivateSkillIds":{ + "shape":"ShortSkillIdList", + "documentation":"

The list of private skill IDs that you want to recommend to the user to enable in the invitation.

" + } + } + }, + "GetNetworkProfileRequest":{ + "type":"structure", + "required":["NetworkProfileArn"], + "members":{ + "NetworkProfileArn":{ + "shape":"Arn", + "documentation":"

The ARN of the network profile associated with a device.

" + } + } + }, + "GetNetworkProfileResponse":{ + "type":"structure", + "members":{ + "NetworkProfile":{ + "shape":"NetworkProfile", + "documentation":"

The network profile associated with a device.

" + } + } + }, "GetProfileRequest":{ "type":"structure", "members":{ @@ -2355,6 +3394,22 @@ "documentation":"

The device is in an invalid state.

", "exception":true }, + "InvalidSecretsManagerResourceException":{ + "type":"structure", + "members":{ + "Message":{"shape":"ErrorMessage"} + }, + "documentation":"

A password in SecretsManager is in an invalid state.

", + "exception":true + }, + "InvalidServiceLinkedRoleStateException":{ + "type":"structure", + "members":{ + "Message":{"shape":"ErrorMessage"} + }, + "documentation":"

The service linked role is locked for deletion.

", + "exception":true + }, "InvalidUserStatusException":{ "type":"structure", "members":{ @@ -2376,6 +3431,32 @@ "documentation":"

You are performing an action that would put you beyond your account's limits.

", "exception":true }, + "ListBusinessReportSchedulesRequest":{ + "type":"structure", + "members":{ + "NextToken":{ + "shape":"NextToken", + "documentation":"

The token used to list the remaining schedules from the previous API call.

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

The maximum number of schedules listed in the call.

" + } + } + }, + "ListBusinessReportSchedulesResponse":{ + "type":"structure", + "members":{ + "BusinessReportSchedules":{ + "shape":"BusinessReportScheduleList", + "documentation":"

The schedule of the reports.

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

The token used to list the remaining schedules from the previous API call.

" + } + } + }, "ListConferenceProvidersRequest":{ "type":"structure", "members":{ @@ -2427,13 +3508,69 @@ "ListDeviceEventsResponse":{ "type":"structure", "members":{ - "DeviceEvents":{ - "shape":"DeviceEventList", - "documentation":"

The device events requested for the device ARN.

" + "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.

" + } + } + }, + "ListGatewayGroupsRequest":{ + "type":"structure", + "members":{ + "NextToken":{ + "shape":"NextToken", + "documentation":"

The token used to paginate though multiple pages of gateway group summaries.

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

The maximum number of gateway group summaries to return. The default is 50.

" + } + } + }, + "ListGatewayGroupsResponse":{ + "type":"structure", + "members":{ + "GatewayGroups":{ + "shape":"GatewayGroupSummaries", + "documentation":"

The gateway groups in the list.

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

The token used to paginate though multiple pages of gateway group summaries.

" + } + } + }, + "ListGatewaysRequest":{ + "type":"structure", + "members":{ + "GatewayGroupArn":{ + "shape":"Arn", + "documentation":"

The gateway group ARN for which to list gateways.

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

The token used to paginate though multiple pages of gateway summaries.

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

The maximum number of gateway summaries to return. The default is 50.

" + } + } + }, + "ListGatewaysResponse":{ + "type":"structure", + "members":{ + "Gateways":{ + "shape":"GatewaySummaries", + "documentation":"

The gateways in the list.

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

The token returned to indicate that there is more data available.

" + "documentation":"

The token used to paginate though multiple pages of gateway summaries.

" } } }, @@ -2594,6 +3731,10 @@ } } }, + "Locale":{ + "type":"string", + "enum":["en-US"] + }, "MacAddress":{"type":"string"}, "MaxResults":{ "type":"integer", @@ -2620,15 +3761,138 @@ "documentation":"

The name sent in the request is already in use.

", "exception":true }, + "NetworkEapMethod":{ + "type":"string", + "enum":["EAP_TLS"] + }, + "NetworkProfile":{ + "type":"structure", + "members":{ + "NetworkProfileArn":{ + "shape":"Arn", + "documentation":"

The ARN of the network profile associated with a device.

" + }, + "NetworkProfileName":{ + "shape":"NetworkProfileName", + "documentation":"

The name of the network profile associated with a device.

" + }, + "Description":{ + "shape":"NetworkProfileDescription", + "documentation":"

Detailed information about a device's network profile.

" + }, + "Ssid":{ + "shape":"NetworkSsid", + "documentation":"

The SSID of the Wi-Fi network.

" + }, + "SecurityType":{ + "shape":"NetworkSecurityType", + "documentation":"

The security type of the Wi-Fi network. This can be WPA2_ENTERPRISE, WPA2_PSK, WPA_PSK, WEP, or OPEN.

" + }, + "EapMethod":{ + "shape":"NetworkEapMethod", + "documentation":"

The authentication standard that is used in the EAP framework. Currently, EAP_TLS is supported.

" + }, + "CurrentPassword":{ + "shape":"CurrentWiFiPassword", + "documentation":"

The current password of the Wi-Fi network.

" + }, + "NextPassword":{ + "shape":"NextWiFiPassword", + "documentation":"

The next, or subsequent, password of the Wi-Fi network. This password is asynchronously transmitted to the device and is used when the password of the network changes to NextPassword.

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

The ARN of the Private Certificate Authority (PCA) created in AWS Certificate Manager (ACM). This is used to issue certificates to the devices.

" + }, + "TrustAnchors":{ + "shape":"TrustAnchorList", + "documentation":"

The root certificates of your authentication server, which is installed on your devices and used to trust your authentication server during EAP negotiation.

" + } + }, + "documentation":"

The network profile associated with a device.

" + }, + "NetworkProfileData":{ + "type":"structure", + "members":{ + "NetworkProfileArn":{ + "shape":"Arn", + "documentation":"

The ARN of the network profile associated with a device.

" + }, + "NetworkProfileName":{ + "shape":"NetworkProfileName", + "documentation":"

The name of the network profile associated with a device.

" + }, + "Description":{ + "shape":"NetworkProfileDescription", + "documentation":"

Detailed information about a device's network profile.

" + }, + "Ssid":{ + "shape":"NetworkSsid", + "documentation":"

The SSID of the Wi-Fi network.

" + }, + "SecurityType":{ + "shape":"NetworkSecurityType", + "documentation":"

The security type of the Wi-Fi network. This can be WPA2_ENTERPRISE, WPA2_PSK, WPA_PSK, WEP, or OPEN.

" + }, + "EapMethod":{ + "shape":"NetworkEapMethod", + "documentation":"

The authentication standard that is used in the EAP framework. Currently, EAP_TLS is supported.

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

The ARN of the Private Certificate Authority (PCA) created in AWS Certificate Manager (ACM). This is used to issue certificates to the devices.

" + } + }, + "documentation":"

The data associated with a network profile.

" + }, + "NetworkProfileDataList":{ + "type":"list", + "member":{"shape":"NetworkProfileData"} + }, + "NetworkProfileDescription":{ + "type":"string", + "max":200, + "min":0, + "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" + }, + "NetworkProfileName":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" + }, + "NetworkSecurityType":{ + "type":"string", + "enum":[ + "OPEN", + "WEP", + "WPA_PSK", + "WPA2_PSK", + "WPA2_ENTERPRISE" + ] + }, + "NetworkSsid":{ + "type":"string", + "max":32, + "min":1, + "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" + }, "NewInThisVersionBulletPoints":{ "type":"list", "member":{"shape":"BulletPoint"} }, "NextToken":{ "type":"string", - "max":1000, + "max":1100, "min":1 }, + "NextWiFiPassword":{ + "type":"string", + "max":128, + "min":0, + "pattern":"(^$)|([\\x00-\\x7F]{5,})", + "sensitive":true + }, "NotFoundException":{ "type":"structure", "members":{ @@ -2647,6 +3911,16 @@ "max":2, "min":1 }, + "OrganizationName":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" + }, + "OutboundPhoneNumber":{ + "type":"string", + "pattern":"\\d{10}" + }, "PSTNDialIn":{ "type":"structure", "required":[ @@ -2661,7 +3935,7 @@ "documentation":"

The zip code.

" }, "PhoneNumber":{ - "shape":"PhoneNumber", + "shape":"OutboundPhoneNumber", "documentation":"

The phone number to call to join the conference.

" }, "OneClickIdDelay":{ @@ -2675,10 +3949,6 @@ }, "documentation":"

The information for public switched telephone network (PSTN) conferencing.

" }, - "PhoneNumber":{ - "type":"string", - "pattern":"\\d{10}" - }, "PrivacyPolicy":{"type":"string"}, "ProductDescription":{"type":"string"}, "ProductId":{ @@ -2807,6 +4077,29 @@ "members":{ } }, + "PutInvitationConfigurationRequest":{ + "type":"structure", + "required":["OrganizationName"], + "members":{ + "OrganizationName":{ + "shape":"OrganizationName", + "documentation":"

The name of the organization sending the enrollment invite to a user.

" + }, + "ContactEmail":{ + "shape":"Email", + "documentation":"

The email ID of the organization or individual contact that the enrolled user can use.

" + }, + "PrivateSkillIds":{ + "shape":"ShortSkillIdList", + "documentation":"

The list of private skill IDs that you want to recommend to the user to enable in the invitation.

" + } + } + }, + "PutInvitationConfigurationResponse":{ + "type":"structure", + "members":{ + } + }, "PutRoomSkillParameterRequest":{ "type":"structure", "required":[ @@ -2958,6 +4251,14 @@ } } }, + "ResourceAssociatedException":{ + "type":"structure", + "members":{ + "Message":{"shape":"ErrorMessage"} + }, + "documentation":"

Another resource is associated with the resource in the request.

", + "exception":true + }, "ResourceInUseException":{ "type":"structure", "members":{ @@ -3096,6 +4397,12 @@ "type":"list", "member":{"shape":"RoomSkillParameter"} }, + "S3KeyPrefix":{ + "type":"string", + "max":100, + "min":0, + "pattern":"[A-Za-z0-9!_\\-\\.\\*'()/]*" + }, "SampleUtterances":{ "type":"list", "member":{"shape":"Utterance"} @@ -3189,11 +4496,11 @@ }, "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).

" + "documentation":"

" }, "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.

" + "documentation":"

The sort order to use in listing the specified set of devices. Supported sort keys are DeviceName, DeviceStatus, RoomName, DeviceType, DeviceSerialNumber, ConnectionStatus, NetworkProfileName, NetworkProfileArn, Feature, and FailureCode.

" } } }, @@ -3214,6 +4521,44 @@ } } }, + "SearchNetworkProfilesRequest":{ + "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 network profiles. Valid filters are NetworkProfileName, Ssid, and SecurityType.

" + }, + "SortCriteria":{ + "shape":"SortList", + "documentation":"

The sort order to use to list the specified set of network profiles. Valid sort criteria includes NetworkProfileName, Ssid, and SecurityType.

" + } + } + }, + "SearchNetworkProfilesResponse":{ + "type":"structure", + "members":{ + "NetworkProfiles":{ + "shape":"NetworkProfileDataList", + "documentation":"

The network profiles that meet the specified set of filter criteria, in sort order. It is a list of NetworkProfileData objects.

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

" + }, + "TotalCount":{ + "shape":"TotalCount", + "documentation":"

The total number of network profiles returned.

" + } + } + }, "SearchProfilesRequest":{ "type":"structure", "members":{ @@ -3366,6 +4711,42 @@ } } }, + "SendAnnouncementRequest":{ + "type":"structure", + "required":[ + "RoomFilters", + "Content", + "ClientRequestToken" + ], + "members":{ + "RoomFilters":{ + "shape":"FilterList", + "documentation":"

The filters to use to send an announcement to a specified list of rooms. The supported filter keys are RoomName, ProfileName, RoomArn, and ProfileArn. To send to all rooms, specify an empty RoomFilters list.

" + }, + "Content":{ + "shape":"Content", + "documentation":"

The announcement content. This can contain only one of the three possible announcement types (text, SSML or audio).

" + }, + "TimeToLiveInSeconds":{ + "shape":"TimeToLiveInSeconds", + "documentation":"

The time to live for an announcement. Default is 300. If delivery doesn't occur within this time, the announcement is not delivered.

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

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

", + "idempotencyToken":true + } + } + }, + "SendAnnouncementResponse":{ + "type":"structure", + "members":{ + "AnnouncementArn":{ + "shape":"Arn", + "documentation":"

The identifier of the announcement.

" + } + } + }, "SendInvitationRequest":{ "type":"structure", "members":{ @@ -3381,6 +4762,12 @@ } }, "ShortDescription":{"type":"string"}, + "ShortSkillIdList":{ + "type":"list", + "member":{"shape":"SkillId"}, + "max":3, + "min":0 + }, "SkillDetails":{ "type":"structure", "members":{ @@ -3494,6 +4881,14 @@ "min":1, "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" }, + "SkillNotLinkedException":{ + "type":"structure", + "members":{ + "Message":{"shape":"ErrorMessage"} + }, + "documentation":"

The skill must be linked to a third-party account.

", + "exception":true + }, "SkillStoreType":{"type":"string"}, "SkillSummary":{ "type":"structure", @@ -3643,6 +5038,35 @@ "DESC" ] }, + "Ssml":{ + "type":"structure", + "required":[ + "Locale", + "Value" + ], + "members":{ + "Locale":{ + "shape":"Locale", + "documentation":"

The locale of the SSML message. Currently, en-US is supported.

" + }, + "Value":{ + "shape":"SsmlValue", + "documentation":"

The value of the SSML message in the correct SSML format. The audio tag is not supported.

" + } + }, + "documentation":"

The SSML message. For more information, see SSML Reference.

" + }, + "SsmlList":{ + "type":"list", + "member":{"shape":"Ssml"}, + "max":1 + }, + "SsmlValue":{ + "type":"string", + "max":4096, + "min":0, + "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" + }, "StartDeviceSyncRequest":{ "type":"structure", "required":["Features"], @@ -3748,13 +5172,56 @@ "CELSIUS" ] }, - "Timestamp":{"type":"timestamp"}, + "Text":{ + "type":"structure", + "required":[ + "Locale", + "Value" + ], + "members":{ + "Locale":{ + "shape":"Locale", + "documentation":"

The locale of the text message. Currently, en-US is supported.

" + }, + "Value":{ + "shape":"TextValue", + "documentation":"

The value of the text message.

" + } + }, + "documentation":"

The text message.

" + }, + "TextList":{ + "type":"list", + "member":{"shape":"Text"}, + "max":1 + }, + "TextValue":{ + "type":"string", + "max":4096, + "min":0, + "pattern":"[\\u0009\\u000A\\u000D\\u0020-\\u007E\\u0085\\u00A0-\\uD7FF\\uE000-\\uFFFD\\u10000-\\u10FFFF]*" + }, + "TimeToLiveInSeconds":{ + "type":"integer", + "max":3600, + "min":1 + }, "Timezone":{ "type":"string", "max":100, "min":1 }, "TotalCount":{"type":"integer"}, + "TrustAnchor":{ + "type":"string", + "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)?" + }, + "TrustAnchorList":{ + "type":"list", + "member":{"shape":"TrustAnchor"}, + "max":5, + "min":1 + }, "UnauthorizedException":{ "type":"structure", "members":{ @@ -3808,6 +5275,41 @@ "members":{ } }, + "UpdateBusinessReportScheduleRequest":{ + "type":"structure", + "required":["ScheduleArn"], + "members":{ + "ScheduleArn":{ + "shape":"Arn", + "documentation":"

The ARN of the business report schedule.

" + }, + "S3BucketName":{ + "shape":"CustomerS3BucketName", + "documentation":"

The S3 location of the output reports.

" + }, + "S3KeyPrefix":{ + "shape":"S3KeyPrefix", + "documentation":"

The S3 key where the report is delivered.

" + }, + "Format":{ + "shape":"BusinessReportFormat", + "documentation":"

The format of the generated report (individual CSV files or zipped files of individual files).

" + }, + "ScheduleName":{ + "shape":"BusinessReportScheduleName", + "documentation":"

The name identifier of the schedule.

" + }, + "Recurrence":{ + "shape":"BusinessReportRecurrence", + "documentation":"

The recurrence of the reports.

" + } + } + }, + "UpdateBusinessReportScheduleResponse":{ + "type":"structure", + "members":{ + } + }, "UpdateConferenceProviderRequest":{ "type":"structure", "required":[ @@ -3892,6 +5394,95 @@ "members":{ } }, + "UpdateGatewayGroupRequest":{ + "type":"structure", + "required":["GatewayGroupArn"], + "members":{ + "GatewayGroupArn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway group to update.

" + }, + "Name":{ + "shape":"GatewayGroupName", + "documentation":"

The updated name of the gateway group.

" + }, + "Description":{ + "shape":"GatewayGroupDescription", + "documentation":"

The updated description of the gateway group.

" + } + } + }, + "UpdateGatewayGroupResponse":{ + "type":"structure", + "members":{ + } + }, + "UpdateGatewayRequest":{ + "type":"structure", + "required":["GatewayArn"], + "members":{ + "GatewayArn":{ + "shape":"Arn", + "documentation":"

The ARN of the gateway to update.

" + }, + "Name":{ + "shape":"GatewayName", + "documentation":"

The updated name of the gateway.

" + }, + "Description":{ + "shape":"GatewayDescription", + "documentation":"

The updated description of the gateway.

" + }, + "SoftwareVersion":{ + "shape":"GatewayVersion", + "documentation":"

The updated software version of the gateway. The gateway automatically updates its software version during normal operation.

" + } + } + }, + "UpdateGatewayResponse":{ + "type":"structure", + "members":{ + } + }, + "UpdateNetworkProfileRequest":{ + "type":"structure", + "required":["NetworkProfileArn"], + "members":{ + "NetworkProfileArn":{ + "shape":"Arn", + "documentation":"

The ARN of the network profile associated with a device.

" + }, + "NetworkProfileName":{ + "shape":"NetworkProfileName", + "documentation":"

The name of the network profile associated with a device.

" + }, + "Description":{ + "shape":"NetworkProfileDescription", + "documentation":"

Detailed information about a device's network profile.

" + }, + "CurrentPassword":{ + "shape":"CurrentWiFiPassword", + "documentation":"

The current password of the Wi-Fi network.

" + }, + "NextPassword":{ + "shape":"NextWiFiPassword", + "documentation":"

The next, or subsequent, password of the Wi-Fi network. This password is asynchronously transmitted to the device and is used when the password of the network changes to NextPassword.

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

The ARN of the Private Certificate Authority (PCA) created in AWS Certificate Manager (ACM). This is used to issue certificates to the devices.

" + }, + "TrustAnchors":{ + "shape":"TrustAnchorList", + "documentation":"

The root certificate(s) of your authentication server that will be installed on your devices and used to trust your authentication server during EAP negotiation.

" + } + } + }, + "UpdateNetworkProfileResponse":{ + "type":"structure", + "members":{ + } + }, "UpdateProfileRequest":{ "type":"structure", "members":{ @@ -4076,5 +5667,5 @@ "pattern":"[a-zA-Z0-9@_+.-]*" } }, - "documentation":"

Alexa for Business helps you use Alexa in your organization. Alexa for Business provides the tools you to manage 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 also make these available as private skills for your organization. Alexa for Business makes it efficient to voice-enable your products and services, thus providing context-aware voice experiences for your customers. In addition, Alexa for Business enables Alexa Voice Services (AVS) device manufacturers to centrally deploy and manage their devices in Alexa for Business as shared devices as a part of their existing management flow.

" + "documentation":"

Alexa for Business helps you use Alexa in your organization. Alexa for Business provides you with the tools to manage 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 also make these available as private skills for your organization. Alexa for Business makes it efficient to voice-enable your products and services, thus providing context-aware voice experiences for your customers. Device makers building with the Alexa Voice Service (AVS) can create fully integrated solutions, register their products with Alexa for Business, and manage them as shared devices in their organization.

" } diff --git a/bin/botocore/data/amplify/2017-07-25/paginators-1.json b/bin/botocore/data/amplify/2017-07-25/paginators-1.json index ea142457..f84208e9 100644 --- a/bin/botocore/data/amplify/2017-07-25/paginators-1.json +++ b/bin/botocore/data/amplify/2017-07-25/paginators-1.json @@ -1,3 +1,28 @@ { - "pagination": {} + "pagination": { + "ListApps": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "apps" + }, + "ListBranches": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "branches" + }, + "ListDomainAssociations": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "domainAssociations" + }, + "ListJobs": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "jobSummaries" + } + } } diff --git a/bin/botocore/data/apigateway/2015-07-09/paginators-1.json b/bin/botocore/data/apigateway/2015-07-09/paginators-1.json index c7a44f17..221e0489 100644 --- a/bin/botocore/data/apigateway/2015-07-09/paginators-1.json +++ b/bin/botocore/data/apigateway/2015-07-09/paginators-1.json @@ -71,6 +71,42 @@ "limit_key": "limit", "output_token": "position", "result_key": "items" + }, + "GetAuthorizers": { + "input_token": "position", + "limit_key": "limit", + "output_token": "position", + "result_key": "items" + }, + "GetDocumentationParts": { + "input_token": "position", + "limit_key": "limit", + "output_token": "position", + "result_key": "items" + }, + "GetDocumentationVersions": { + "input_token": "position", + "limit_key": "limit", + "output_token": "position", + "result_key": "items" + }, + "GetGatewayResponses": { + "input_token": "position", + "limit_key": "limit", + "output_token": "position", + "result_key": "items" + }, + "GetRequestValidators": { + "input_token": "position", + "limit_key": "limit", + "output_token": "position", + "result_key": "items" + }, + "GetSdkTypes": { + "input_token": "position", + "limit_key": "limit", + "output_token": "position", + "result_key": "items" } } } diff --git a/bin/botocore/data/apigateway/2015-07-09/service-2.json b/bin/botocore/data/apigateway/2015-07-09/service-2.json index bed54532..126924b9 100644 --- a/bin/botocore/data/apigateway/2015-07-09/service-2.json +++ b/bin/botocore/data/apigateway/2015-07-09/service-2.json @@ -2059,6 +2059,10 @@ "stageKeys":{ "shape":"ListOfString", "documentation":"

A list of Stage resources that are associated with the ApiKey resource.

" + }, + "tags":{ + "shape":"MapOfStringToString", + "documentation":"

The collection of tags. Each tag element is associated with a given 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.

Use API Keys

" @@ -2299,6 +2303,10 @@ "expirationDate":{ "shape":"Timestamp", "documentation":"

The timestamp when the client certificate will expire.

" + }, + "tags":{ + "shape":"MapOfStringToString", + "documentation":"

The collection of tags. Each tag element is associated with a given resource.

" } }, "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.

Use Client-Side Certificate

" @@ -2368,6 +2376,10 @@ "customerId":{ "shape":"String", "documentation":"

An AWS Marketplace customer identifier , when integrating with the AWS SaaS Marketplace.

" + }, + "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":"

Request to create an ApiKey resource.

" @@ -2590,6 +2602,10 @@ "endpointConfiguration":{ "shape":"EndpointConfiguration", "documentation":"

The endpoint configuration of this DomainName showing the endpoint types of the domain name.

" + }, + "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":"

A request to create a new domain name.

" @@ -2718,6 +2734,10 @@ "policy":{ "shape":"String", "documentation":"A stringified JSON policy document that applies to this RestApi regardless of the caller and Method configuration." + }, + "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":"

The POST Request to add a new RestApi resource to your collection.

" @@ -2827,6 +2847,10 @@ "quota":{ "shape":"QuotaSettings", "documentation":"

The quota of the usage plan.

" + }, + "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":"

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.

" @@ -2849,6 +2873,10 @@ "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.

" + }, + "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":"

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.

" @@ -3523,6 +3551,10 @@ "endpointConfiguration":{ "shape":"EndpointConfiguration", "documentation":"

The endpoint configuration of this DomainName showing the endpoint types of the domain name.

" + }, + "tags":{ + "shape":"MapOfStringToString", + "documentation":"

The collection of tags. Each tag element is associated with a given resource.

" } }, "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.

Set a Custom Host Name for an API

" @@ -3695,6 +3727,10 @@ "description":{ "shape":"String", "documentation":"

The description of the ClientCertificate.

" + }, + "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":"

A request to generate a ClientCertificate resource.

" @@ -5859,6 +5895,10 @@ "policy":{ "shape":"String", "documentation":"A stringified JSON policy document that applies to this RestApi regardless of the caller and Method configuration." + }, + "tags":{ + "shape":"MapOfStringToString", + "documentation":"

The collection of tags. Each tag element is associated with a given resource.

" } }, "documentation":"

Represents a REST API.

Create an API

" @@ -6943,6 +6983,10 @@ "productCode":{ "shape":"String", "documentation":"

The AWS Markeplace product identifier to associate with the usage plan as a SaaS product on AWS Marketplace.

" + }, + "tags":{ + "shape":"MapOfStringToString", + "documentation":"

The collection of tags. Each tag element is associated with a given resource.

" } }, "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.

Create and Use Usage Plans

" @@ -7019,6 +7063,10 @@ "statusMessage":{ "shape":"String", "documentation":"

A description about the VPC link status.

" + }, + "tags":{ + "shape":"MapOfStringToString", + "documentation":"

The collection of tags. Each tag element is associated with a given resource.

" } }, "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.

" diff --git a/bin/botocore/data/apigatewaymanagementapi/2018-11-29/paginators-1.json b/bin/botocore/data/apigatewaymanagementapi/2018-11-29/paginators-1.json new file mode 100644 index 00000000..ea142457 --- /dev/null +++ b/bin/botocore/data/apigatewaymanagementapi/2018-11-29/paginators-1.json @@ -0,0 +1,3 @@ +{ + "pagination": {} +} diff --git a/bin/botocore/data/apigatewaymanagementapi/2018-11-29/service-2.json b/bin/botocore/data/apigatewaymanagementapi/2018-11-29/service-2.json new file mode 100644 index 00000000..eea6c940 --- /dev/null +++ b/bin/botocore/data/apigatewaymanagementapi/2018-11-29/service-2.json @@ -0,0 +1,109 @@ +{ + "metadata" : { + "apiVersion" : "2018-11-29", + "endpointPrefix" : "execute-api", + "signingName" : "execute-api", + "serviceFullName" : "AmazonApiGatewayManagementApi", + "serviceId" : "ApiGatewayManagementApi", + "protocol" : "rest-json", + "jsonVersion" : "1.1", + "uid" : "apigatewaymanagementapi-2018-11-29", + "signatureVersion" : "v4" + }, + "operations" : { + "PostToConnection" : { + "name" : "PostToConnection", + "http" : { + "method" : "POST", + "requestUri" : "/@connections/{connectionId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "PostToConnectionRequest" + }, + "errors" : [ { + "shape" : "GoneException", + "documentation" : "

The connection with the provided id no longer exists.

" + }, { + "shape" : "LimitExceededException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" + }, { + "shape" : "PayloadTooLargeException", + "documentation" : "

The data has exceeded the maximum size allowed.

" + }, { + "shape" : "ForbiddenException", + "documentation" : "

The caller is not authorized to invoke this operation.

" + } ], + "documentation" : "

Sends the provided data to the specified connection.

" + } + }, + "shapes" : { + "Data" : { + "type" : "blob", + "max" : 131072, + "documentation" : "

The data to be sent to the client specified by its connection id.

" + }, + "ForbiddenException" : { + "type" : "structure", + "members" : { }, + "exception" : true, + "error" : { + "httpStatusCode" : 403 + }, + "documentation" : "

The caller is not authorized to invoke this operation.

" + }, + "GoneException" : { + "type" : "structure", + "members" : { }, + "exception" : true, + "error" : { + "httpStatusCode" : 410 + }, + "documentation" : "

The connection with the provided id no longer exists.

" + }, + "LimitExceededException" : { + "type" : "structure", + "members" : { }, + "exception" : true, + "error" : { + "httpStatusCode" : 429 + }, + "documentation" : "

The client is sending more than the allowed number of requests per unit of time.

" + }, + "PayloadTooLargeException" : { + "type" : "structure", + "members" : { + "Message" : { + "shape" : "__string", + "locationName" : "message" + } + }, + "exception" : true, + "error" : { + "httpStatusCode" : 413 + }, + "documentation" : "

The data has exceeded the maximum size allowed.

" + }, + "PostToConnectionRequest" : { + "type" : "structure", + "members" : { + "Data" : { + "shape" : "Data", + "documentation" : "

The data to be sent to the client specified by its connection id.

" + }, + "ConnectionId" : { + "shape" : "__string", + "location" : "uri", + "locationName" : "connectionId", + "documentation" : "

The identifier of the connection that a specific client is using.

" + } + }, + "required" : [ "ConnectionId", "Data" ], + "payload" : "Data" + }, + "__string" : { + "type" : "string" + } + }, + "documentation" : "

The Amazon API Gateway Management API allows you to directly manage runtime aspects of your deployed APIs. To use it, you must explicitly set the SDK's endpoint to point to the endpoint of your deployed API. The endpoint will be of the form https://{api-id}.execute-api.{region}.amazonaws.com/{stage}, or will be the endpoint corresponding to your API's custom domain and base path, if applicable.

" +} diff --git a/bin/botocore/data/apigatewayv2/2018-11-29/paginators-1.json b/bin/botocore/data/apigatewayv2/2018-11-29/paginators-1.json new file mode 100644 index 00000000..2f57dd2c --- /dev/null +++ b/bin/botocore/data/apigatewayv2/2018-11-29/paginators-1.json @@ -0,0 +1,64 @@ +{ + "pagination": { + "GetApis": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Items" + }, + "GetAuthorizers": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Items" + }, + "GetDeployments": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Items" + }, + "GetDomainNames": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Items" + }, + "GetIntegrationResponses": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Items" + }, + "GetIntegrations": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Items" + }, + "GetModels": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Items" + }, + "GetRouteResponses": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Items" + }, + "GetRoutes": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Items" + }, + "GetStages": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Items" + } + } +} diff --git a/bin/botocore/data/apigatewayv2/2018-11-29/service-2.json b/bin/botocore/data/apigatewayv2/2018-11-29/service-2.json new file mode 100644 index 00000000..d8b06e1a --- /dev/null +++ b/bin/botocore/data/apigatewayv2/2018-11-29/service-2.json @@ -0,0 +1,6674 @@ +{ + "metadata" : { + "apiVersion" : "2018-11-29", + "endpointPrefix" : "apigateway", + "signingName" : "apigateway", + "serviceFullName" : "AmazonApiGatewayV2", + "serviceId" : "ApiGatewayV2", + "protocol" : "rest-json", + "jsonVersion" : "1.1", + "uid" : "apigatewayv2-2018-11-29", + "signatureVersion" : "v4" + }, + "operations" : { + "CreateApi" : { + "name" : "CreateApi", + "http" : { + "method" : "POST", + "requestUri" : "/v2/apis", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateApiRequest" + }, + "output" : { + "shape" : "CreateApiResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates an Api resource.

" + }, + "CreateApiMapping" : { + "name" : "CreateApiMapping", + "http" : { + "method" : "POST", + "requestUri" : "/v2/domainnames/{domainName}/apimappings", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateApiMappingRequest" + }, + "output" : { + "shape" : "CreateApiMappingResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates an API mapping.

" + }, + "CreateAuthorizer" : { + "name" : "CreateAuthorizer", + "http" : { + "method" : "POST", + "requestUri" : "/v2/apis/{apiId}/authorizers", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateAuthorizerRequest" + }, + "output" : { + "shape" : "CreateAuthorizerResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates an Authorizer for an API.

" + }, + "CreateDeployment" : { + "name" : "CreateDeployment", + "http" : { + "method" : "POST", + "requestUri" : "/v2/apis/{apiId}/deployments", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateDeploymentRequest" + }, + "output" : { + "shape" : "CreateDeploymentResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates a Deployment for an API.

" + }, + "CreateDomainName" : { + "name" : "CreateDomainName", + "http" : { + "method" : "POST", + "requestUri" : "/v2/domainnames", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateDomainNameRequest" + }, + "output" : { + "shape" : "CreateDomainNameResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates a domain name.

" + }, + "CreateIntegration" : { + "name" : "CreateIntegration", + "http" : { + "method" : "POST", + "requestUri" : "/v2/apis/{apiId}/integrations", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateIntegrationRequest" + }, + "output" : { + "shape" : "CreateIntegrationResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates an Integration.

" + }, + "CreateIntegrationResponse" : { + "name" : "CreateIntegrationResponse", + "http" : { + "method" : "POST", + "requestUri" : "/v2/apis/{apiId}/integrations/{integrationId}/integrationresponses", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateIntegrationResponseRequest" + }, + "output" : { + "shape" : "CreateIntegrationResponseResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates an IntegrationResponses.

" + }, + "CreateModel" : { + "name" : "CreateModel", + "http" : { + "method" : "POST", + "requestUri" : "/v2/apis/{apiId}/models", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateModelRequest" + }, + "output" : { + "shape" : "CreateModelResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates a Model for an API.

" + }, + "CreateRoute" : { + "name" : "CreateRoute", + "http" : { + "method" : "POST", + "requestUri" : "/v2/apis/{apiId}/routes", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateRouteRequest" + }, + "output" : { + "shape" : "CreateRouteResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates a Route for an API.

" + }, + "CreateRouteResponse" : { + "name" : "CreateRouteResponse", + "http" : { + "method" : "POST", + "requestUri" : "/v2/apis/{apiId}/routes/{routeId}/routeresponses", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateRouteResponseRequest" + }, + "output" : { + "shape" : "CreateRouteResponseResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates a RouteResponse for a Route.

" + }, + "CreateStage" : { + "name" : "CreateStage", + "http" : { + "method" : "POST", + "requestUri" : "/v2/apis/{apiId}/stages", + "responseCode" : 201 + }, + "input" : { + "shape" : "CreateStageRequest" + }, + "output" : { + "shape" : "CreateStageResponse", + "documentation" : "

The request has succeeded and has resulted in the creation of a resource.

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Creates a Stage for an API.

" + }, + "DeleteApi" : { + "name" : "DeleteApi", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/apis/{apiId}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteApiRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Deletes an Api resource.

" + }, + "DeleteApiMapping" : { + "name" : "DeleteApiMapping", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/domainnames/{domainName}/apimappings/{apiMappingId}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteApiMappingRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Deletes an API mapping.

" + }, + "DeleteAuthorizer" : { + "name" : "DeleteAuthorizer", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/apis/{apiId}/authorizers/{authorizerId}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteAuthorizerRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Deletes an Authorizer.

" + }, + "DeleteDeployment" : { + "name" : "DeleteDeployment", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/apis/{apiId}/deployments/{deploymentId}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteDeploymentRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Deletes a Deployment.

" + }, + "DeleteDomainName" : { + "name" : "DeleteDomainName", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/domainnames/{domainName}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteDomainNameRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Deletes a domain name.

" + }, + "DeleteIntegration" : { + "name" : "DeleteIntegration", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/apis/{apiId}/integrations/{integrationId}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteIntegrationRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Deletes an Integration.

" + }, + "DeleteIntegrationResponse" : { + "name" : "DeleteIntegrationResponse", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/apis/{apiId}/integrations/{integrationId}/integrationresponses/{integrationResponseId}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteIntegrationResponseRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Deletes an IntegrationResponses.

" + }, + "DeleteModel" : { + "name" : "DeleteModel", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/apis/{apiId}/models/{modelId}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteModelRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Deletes a Model.

" + }, + "DeleteRoute" : { + "name" : "DeleteRoute", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/apis/{apiId}/routes/{routeId}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteRouteRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Deletes a Route.

" + }, + "DeleteRouteResponse" : { + "name" : "DeleteRouteResponse", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/apis/{apiId}/routes/{routeId}/routeresponses/{routeResponseId}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteRouteResponseRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Deletes a RouteResponse.

" + }, + "DeleteStage" : { + "name" : "DeleteStage", + "http" : { + "method" : "DELETE", + "requestUri" : "/v2/apis/{apiId}/stages/{stageName}", + "responseCode" : 204 + }, + "input" : { + "shape" : "DeleteStageRequest" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Deletes a Stage.

" + }, + "GetApi" : { + "name" : "GetApi", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetApiRequest" + }, + "output" : { + "shape" : "GetApiResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets an Api resource.

" + }, + "GetApiMapping" : { + "name" : "GetApiMapping", + "http" : { + "method" : "GET", + "requestUri" : "/v2/domainnames/{domainName}/apimappings/{apiMappingId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetApiMappingRequest" + }, + "output" : { + "shape" : "GetApiMappingResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

The API mapping.

" + }, + "GetApiMappings" : { + "name" : "GetApiMappings", + "http" : { + "method" : "GET", + "requestUri" : "/v2/domainnames/{domainName}/apimappings", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetApiMappingsRequest" + }, + "output" : { + "shape" : "GetApiMappingsResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

The API mappings.

" + }, + "GetApis" : { + "name" : "GetApis", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetApisRequest" + }, + "output" : { + "shape" : "GetApisResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Gets a collection of Api resources.

" + }, + "GetAuthorizer" : { + "name" : "GetAuthorizer", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/authorizers/{authorizerId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetAuthorizerRequest" + }, + "output" : { + "shape" : "GetAuthorizerResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets an Authorizer.

" + }, + "GetAuthorizers" : { + "name" : "GetAuthorizers", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/authorizers", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetAuthorizersRequest" + }, + "output" : { + "shape" : "GetAuthorizersResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Gets the Authorizers for an API.

" + }, + "GetDeployment" : { + "name" : "GetDeployment", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/deployments/{deploymentId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetDeploymentRequest" + }, + "output" : { + "shape" : "GetDeploymentResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets a Deployment.

" + }, + "GetDeployments" : { + "name" : "GetDeployments", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/deployments", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetDeploymentsRequest" + }, + "output" : { + "shape" : "GetDeploymentsResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Gets the Deployments for an API.

" + }, + "GetDomainName" : { + "name" : "GetDomainName", + "http" : { + "method" : "GET", + "requestUri" : "/v2/domainnames/{domainName}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetDomainNameRequest" + }, + "output" : { + "shape" : "GetDomainNameResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets a domain name.

" + }, + "GetDomainNames" : { + "name" : "GetDomainNames", + "http" : { + "method" : "GET", + "requestUri" : "/v2/domainnames", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetDomainNamesRequest" + }, + "output" : { + "shape" : "GetDomainNamesResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Gets the domain names for an AWS account.

" + }, + "GetIntegration" : { + "name" : "GetIntegration", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/integrations/{integrationId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetIntegrationRequest" + }, + "output" : { + "shape" : "GetIntegrationResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets an Integration.

" + }, + "GetIntegrationResponse" : { + "name" : "GetIntegrationResponse", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/integrations/{integrationId}/integrationresponses/{integrationResponseId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetIntegrationResponseRequest" + }, + "output" : { + "shape" : "GetIntegrationResponseResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets an IntegrationResponses.

" + }, + "GetIntegrationResponses" : { + "name" : "GetIntegrationResponses", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/integrations/{integrationId}/integrationresponses", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetIntegrationResponsesRequest" + }, + "output" : { + "shape" : "GetIntegrationResponsesResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Gets the IntegrationResponses for an Integration.

" + }, + "GetIntegrations" : { + "name" : "GetIntegrations", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/integrations", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetIntegrationsRequest" + }, + "output" : { + "shape" : "GetIntegrationsResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Gets the Integrations for an API.

" + }, + "GetModel" : { + "name" : "GetModel", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/models/{modelId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetModelRequest" + }, + "output" : { + "shape" : "GetModelResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets a Model.

" + }, + "GetModelTemplate" : { + "name" : "GetModelTemplate", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/models/{modelId}/template", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetModelTemplateRequest" + }, + "output" : { + "shape" : "GetModelTemplateResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets a model template.

" + }, + "GetModels" : { + "name" : "GetModels", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/models", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetModelsRequest" + }, + "output" : { + "shape" : "GetModelsResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Gets the Models for an API.

" + }, + "GetRoute" : { + "name" : "GetRoute", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/routes/{routeId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetRouteRequest" + }, + "output" : { + "shape" : "GetRouteResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets a Route.

" + }, + "GetRouteResponse" : { + "name" : "GetRouteResponse", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/routes/{routeId}/routeresponses/{routeResponseId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetRouteResponseRequest" + }, + "output" : { + "shape" : "GetRouteResponseResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets a RouteResponse.

" + }, + "GetRouteResponses" : { + "name" : "GetRouteResponses", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/routes/{routeId}/routeresponses", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetRouteResponsesRequest" + }, + "output" : { + "shape" : "GetRouteResponsesResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Gets the RouteResponses for a Route.

" + }, + "GetRoutes" : { + "name" : "GetRoutes", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/routes", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetRoutesRequest" + }, + "output" : { + "shape" : "GetRoutesResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Gets the Routes for an API.

" + }, + "GetStage" : { + "name" : "GetStage", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/stages/{stageName}", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetStageRequest" + }, + "output" : { + "shape" : "GetStageResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + } ], + "documentation" : "

Gets a Stage.

" + }, + "GetStages" : { + "name" : "GetStages", + "http" : { + "method" : "GET", + "requestUri" : "/v2/apis/{apiId}/stages", + "responseCode" : 200 + }, + "input" : { + "shape" : "GetStagesRequest" + }, + "output" : { + "shape" : "GetStagesResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + } ], + "documentation" : "

Gets the Stages for an API.

" + }, + "UpdateApi" : { + "name" : "UpdateApi", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/apis/{apiId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateApiRequest" + }, + "output" : { + "shape" : "UpdateApiResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Updates an Api resource.

" + }, + "UpdateApiMapping" : { + "name" : "UpdateApiMapping", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/domainnames/{domainName}/apimappings/{apiMappingId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateApiMappingRequest" + }, + "output" : { + "shape" : "UpdateApiMappingResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

The API mapping.

" + }, + "UpdateAuthorizer" : { + "name" : "UpdateAuthorizer", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/apis/{apiId}/authorizers/{authorizerId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateAuthorizerRequest" + }, + "output" : { + "shape" : "UpdateAuthorizerResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Updates an Authorizer.

" + }, + "UpdateDeployment" : { + "name" : "UpdateDeployment", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/apis/{apiId}/deployments/{deploymentId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateDeploymentRequest" + }, + "output" : { + "shape" : "UpdateDeploymentResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Updates a Deployment.

" + }, + "UpdateDomainName" : { + "name" : "UpdateDomainName", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/domainnames/{domainName}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateDomainNameRequest" + }, + "output" : { + "shape" : "UpdateDomainNameResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Updates a domain name.

" + }, + "UpdateIntegration" : { + "name" : "UpdateIntegration", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/apis/{apiId}/integrations/{integrationId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateIntegrationRequest" + }, + "output" : { + "shape" : "UpdateIntegrationResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Updates an Integration.

" + }, + "UpdateIntegrationResponse" : { + "name" : "UpdateIntegrationResponse", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/apis/{apiId}/integrations/{integrationId}/integrationresponses/{integrationResponseId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateIntegrationResponseRequest" + }, + "output" : { + "shape" : "UpdateIntegrationResponseResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Updates an IntegrationResponses.

" + }, + "UpdateModel" : { + "name" : "UpdateModel", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/apis/{apiId}/models/{modelId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateModelRequest" + }, + "output" : { + "shape" : "UpdateModelResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Updates a Model.

" + }, + "UpdateRoute" : { + "name" : "UpdateRoute", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/apis/{apiId}/routes/{routeId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateRouteRequest" + }, + "output" : { + "shape" : "UpdateRouteResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Updates a Route.

" + }, + "UpdateRouteResponse" : { + "name" : "UpdateRouteResponse", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/apis/{apiId}/routes/{routeId}/routeresponses/{routeResponseId}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateRouteResponseRequest" + }, + "output" : { + "shape" : "UpdateRouteResponseResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Updates a RouteResponse.

" + }, + "UpdateStage" : { + "name" : "UpdateStage", + "http" : { + "method" : "PATCH", + "requestUri" : "/v2/apis/{apiId}/stages/{stageName}", + "responseCode" : 200 + }, + "input" : { + "shape" : "UpdateStageRequest" + }, + "output" : { + "shape" : "UpdateStageResponse", + "documentation" : "

Success

" + }, + "errors" : [ { + "shape" : "NotFoundException", + "documentation" : "

The resource specified in the request was not found.

" + }, { + "shape" : "TooManyRequestsException", + "documentation" : "

The client is sending more than the allowed number of requests per unit of\n time.

" + }, { + "shape" : "BadRequestException", + "documentation" : "

One of the parameters in the request is invalid.

" + }, { + "shape" : "ConflictException", + "documentation" : "

The resource already exists.

" + } ], + "documentation" : "

Updates a Stage.

" + } + }, + "shapes" : { + "AccessLogSettings" : { + "type" : "structure", + "members" : { + "DestinationArn" : { + "shape" : "Arn", + "locationName" : "destinationArn", + "documentation" : "

The ARN of the CloudWatch Logs log group to receive access logs.

" + }, + "Format" : { + "shape" : "StringWithLengthBetween1And1024", + "locationName" : "format", + "documentation" : "

A single line format of the access logs of data, as specified by selected $context\n variables. The format must include at least $context.requestId.

" + } + }, + "documentation" : "

Settings for logging access in a stage.

" + }, + "Api" : { + "type" : "structure", + "members" : { + "ApiEndpoint" : { + "shape" : "__string", + "locationName" : "apiEndpoint", + "documentation" : "

The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The\n stage name is typically appended to this URI to form a complete path to a deployed\n API stage.

" + }, + "ApiId" : { + "shape" : "Id", + "locationName" : "apiId", + "documentation" : "

The API ID.

" + }, + "ApiKeySelectionExpression" : { + "shape" : "SelectionExpression", + "locationName" : "apiKeySelectionExpression", + "documentation" : "

An API key selection expression. See API Key Selection Expressions.

" + }, + "CreatedDate" : { + "shape" : "__timestampIso8601", + "locationName" : "createdDate", + "documentation" : "

The timestamp when the API was created.

" + }, + "Description" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "description", + "documentation" : "

The description of the API.

" + }, + "DisableSchemaValidation" : { + "shape" : "__boolean", + "locationName" : "disableSchemaValidation", + "documentation" : "

Avoid validating models when creating a deployment.

" + }, + "Name" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "name", + "documentation" : "

The name of the API.

" + }, + "ProtocolType" : { + "shape" : "ProtocolType", + "locationName" : "protocolType", + "documentation" : "

The API protocol: Currently only WEBSOCKET is supported.

" + }, + "RouteSelectionExpression" : { + "shape" : "SelectionExpression", + "locationName" : "routeSelectionExpression", + "documentation" : "

The route selection expression for the API.

" + }, + "Version" : { + "shape" : "StringWithLengthBetween1And64", + "locationName" : "version", + "documentation" : "

A version identifier for the API.

" + }, + "Warnings" : { + "shape" : "__listOf__string", + "locationName" : "warnings", + "documentation" : "

The warning messages reported when failonwarnings is turned on during\n API import.

" + } + }, + "documentation" : "

Represents an API.

", + "required" : [ "RouteSelectionExpression", "ProtocolType", "Name" ] + }, + "ApiMapping" : { + "type" : "structure", + "members" : { + "ApiId" : { + "shape" : "Id", + "locationName" : "apiId", + "documentation" : "

The API identifier.

" + }, + "ApiMappingId" : { + "shape" : "Id", + "locationName" : "apiMappingId", + "documentation" : "

The API mapping identifier.

" + }, + "ApiMappingKey" : { + "shape" : "SelectionKey", + "locationName" : "apiMappingKey", + "documentation" : "

The API mapping key.

" + }, + "Stage" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "stage", + "documentation" : "

The API stage.

" + } + }, + "documentation" : "

Represents an API mapping.

", + "required" : [ "Stage", "ApiId" ] + }, + "ApiMappings" : { + "type" : "structure", + "members" : { + "Items" : { + "shape" : "__listOfApiMapping", + "locationName" : "items", + "documentation" : "

The elements from this collection.

" + }, + "NextToken" : { + "shape" : "NextToken", + "locationName" : "nextToken", + "documentation" : "

The next page of elements from this collection. Not valid for the last element of\n the collection.

" + } + }, + "documentation" : "

Represents a collection of ApiMappings resources.

" + }, + "Apis" : { + "type" : "structure", + "members" : { + "Items" : { + "shape" : "__listOfApi", + "locationName" : "items", + "documentation" : "

The elements from this collection.

" + }, + "NextToken" : { + "shape" : "NextToken", + "locationName" : "nextToken", + "documentation" : "

The next page of elements from this collection. Not valid for the last element of\n the collection.

" + } + }, + "documentation" : "

Represents a collection of APIs.

" + }, + "Arn" : { + "type" : "string", + "documentation" : "

Represents an Amazon Resource Name (ARN).

" + }, + "AuthorizationScopes" : { + "type" : "list", + "documentation" : "

A list of authorization scopes configured on a route. The scopes are used with a\n COGNITO_USER_POOLS authorizer to authorize the method invocation. The authorization\n works by matching the route scopes against the scopes parsed from the access token in\n the incoming request. The method invocation is authorized if any route scope matches\n a claimed scope in the access token. Otherwise, the invocation is not authorized.\n When the route scope is configured, the client must provide an access token instead\n of an identity token for authorization purposes.

", + "member" : { + "shape" : "StringWithLengthBetween1And64" + } + }, + "AuthorizationType" : { + "type" : "string", + "documentation" : "

The authorization type. Valid values are NONE for open access,\n AWS_IAM for using AWS IAM permissions, and CUSTOM for\n using a Lambda authorizer.

", + "enum" : [ "NONE", "AWS_IAM", "CUSTOM" ] + }, + "Authorizer" : { + "type" : "structure", + "members" : { + "AuthorizerCredentialsArn" : { + "shape" : "Arn", + "locationName" : "authorizerCredentialsArn", + "documentation" : "

Specifies the required credentials as an IAM role for API Gateway to invoke the\n authorizer. To specify an IAM role for API Gateway to assume, use the role's Amazon\n Resource Name (ARN). To use resource-based permissions on the Lambda function,\n specify null.

" + }, + "AuthorizerId" : { + "shape" : "Id", + "locationName" : "authorizerId", + "documentation" : "

The authorizer identifier.

" + }, + "AuthorizerResultTtlInSeconds" : { + "shape" : "IntegerWithLengthBetween0And3600", + "locationName" : "authorizerResultTtlInSeconds", + "documentation" : "

The time to live (TTL), in seconds, of cached authorizer results. If it equals 0,\n authorization caching is disabled. If it is greater than 0, API Gateway will cache\n authorizer responses. If this field is not set, the default value is 300. The maximum\n value is 3600, or 1 hour.

" + }, + "AuthorizerType" : { + "shape" : "AuthorizerType", + "locationName" : "authorizerType", + "documentation" : "

The authorizer type. Currently the only valid value is REQUEST, for a\n Lambda function using incoming request parameters.

" + }, + "AuthorizerUri" : { + "shape" : "UriWithLengthBetween1And2048", + "locationName" : "authorizerUri", + "documentation" : "

The authorizer's Uniform Resource Identifier (URI).\n ForREQUEST authorizers, this must be a\n well-formed Lambda function URI, for example,\n 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.\n In general, the URI has this form:\n arn:aws:apigateway:{region}:lambda:path/{service_api}\n , where {region} is the same as the region hosting the Lambda\n function, path indicates that the remaining substring in the URI should be treated as\n the path to the resource, including the initial /. For Lambda functions,\n this is usually of the form\n /2015-03-31/functions/[FunctionARN]/invocations.

" + }, + "IdentitySource" : { + "shape" : "IdentitySourceList", + "locationName" : "identitySource", + "documentation" : "

The identity source for which authorization is requested.

For the REQUEST authorizer, this is required when authorization\n caching is enabled. The value is a comma-separated string of one or more mapping\n expressions of the specified request parameters. For example, if an Auth\n header and a Name query string parameters are defined as identity\n sources, this value is method.request.header.Auth,\n method.request.querystring.Name. These parameters will be used to\n derive the authorization caching key and to perform runtime validation of the\n REQUEST authorizer by verifying all of the identity-related request\n parameters are present, not null, and non-empty. Only when this is true does the\n authorizer invoke the authorizer Lambda function, otherwise, it returns a 401\n Unauthorized response without calling the Lambda function. The valid value\n is a string of comma-separated mapping expressions of the specified request\n parameters. When the authorization caching is not enabled, this property is\n optional.

" + }, + "IdentityValidationExpression" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "identityValidationExpression", + "documentation" : "

The\n validation expression does not apply to the REQUEST authorizer.

" + }, + "Name" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "name", + "documentation" : "

The name of the authorizer.

" + }, + "ProviderArns" : { + "shape" : "ProviderArnList", + "locationName" : "providerArns", + "documentation" : "

For\n REQUEST authorizer, this is not\n defined.

" + } + }, + "documentation" : "

Represents an authorizer.

", + "required" : [ "Name" ] + }, + "AuthorizerType" : { + "type" : "string", + "documentation" : "

The authorizer type. Currently the only valid value is REQUEST, for a\n Lambda function using incoming request parameters.

", + "enum" : [ "REQUEST" ] + }, + "Authorizers" : { + "type" : "structure", + "members" : { + "Items" : { + "shape" : "__listOfAuthorizer", + "locationName" : "items", + "documentation" : "

The elements from this collection.

" + }, + "NextToken" : { + "shape" : "NextToken", + "locationName" : "nextToken", + "documentation" : "

The next page of elements from this collection. Not valid for the last element of\n the collection.

" + } + }, + "documentation" : "

Represents a collection of authorizers.

" + }, + "BadRequestException" : { + "type" : "structure", + "members" : { + "Message" : { + "shape" : "__string", + "locationName" : "message", + "documentation" : "

Describes the error encountered.

" + } + }, + "documentation" : "

The request is not valid, for example, the input is incomplete or incorrect. See\n the accompanying error message for details.

", + "exception" : true, + "error" : { + "httpStatusCode" : 400 + } + }, + "ConflictException" : { + "type" : "structure", + "members" : { + "Message" : { + "shape" : "__string", + "locationName" : "message", + "documentation" : "

Describes the error encountered.

" + } + }, + "documentation" : "

The requested operation would cause a conflict with the current state of a service\n resource associated with the request. Resolve the conflict before retrying this\n request. See the accompanying error message for details.

", + "exception" : true, + "error" : { + "httpStatusCode" : 409 + } + }, + "ConnectionType" : { + "type" : "string", + "documentation" : "

Represents a connection type.

", + "enum" : [ "INTERNET", "VPC_LINK" ] + }, + "ContentHandlingStrategy" : { + "type" : "string", + "documentation" : "

Specifies how to handle response payload content type conversions.

", + "enum" : [ "CONVERT_TO_BINARY", "CONVERT_TO_TEXT" ] + }, + "CreateApiInput" : { + "type" : "structure", + "members" : { + "ApiKeySelectionExpression" : { + "shape" : "SelectionExpression", + "locationName" : "apiKeySelectionExpression", + "documentation" : "

An API key selection expression. See API Key Selection Expressions.

" + }, + "Description" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "description", + "documentation" : "

The description of the API.

" + }, + "DisableSchemaValidation" : { + "shape" : "__boolean", + "locationName" : "disableSchemaValidation", + "documentation" : "

Avoid validating models when creating a deployment.

" + }, + "Name" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "name", + "documentation" : "

The name of the API.

" + }, + "ProtocolType" : { + "shape" : "ProtocolType", + "locationName" : "protocolType", + "documentation" : "

The API protocol: Currently only WEBSOCKET is supported.

" + }, + "RouteSelectionExpression" : { + "shape" : "SelectionExpression", + "locationName" : "routeSelectionExpression", + "documentation" : "

The route selection expression for the API.

" + }, + "Version" : { + "shape" : "StringWithLengthBetween1And64", + "locationName" : "version", + "documentation" : "

A version identifier for the API.

" + } + }, + "documentation" : "

Represents the input parameters for a CreateApi request.

", + "required" : [ "RouteSelectionExpression", "ProtocolType", "Name" ] + }, + "CreateApiMappingInput" : { + "type" : "structure", + "members" : { + "ApiId" : { + "shape" : "Id", + "locationName" : "apiId", + "documentation" : "

The API identifier.

" + }, + "ApiMappingKey" : { + "shape" : "SelectionKey", + "locationName" : "apiMappingKey", + "documentation" : "" + }, + "Stage" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "stage", + "documentation" : "

The API stage.

" + } + }, + "documentation" : "

Represents the input parameters for a CreateApiMapping\n request.

", + "required" : [ "Stage", "ApiId" ] + }, + "CreateApiMappingRequest" : { + "type" : "structure", + "members" : { + "ApiId" : { + "shape" : "Id", + "locationName" : "apiId", + "documentation" : "

The API identifier.

" + }, + "ApiMappingKey" : { + "shape" : "SelectionKey", + "locationName" : "apiMappingKey", + "documentation" : "" + }, + "DomainName" : { + "shape" : "__string", + "location" : "uri", + "locationName" : "domainName", + "documentation" : "

The domain name.

" + }, + "Stage" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "stage", + "documentation" : "

The API stage.

" + } + }, + "required" : [ "DomainName", "Stage", "ApiId" ] + }, + "CreateApiMappingResponse" : { + "type" : "structure", + "members" : { + "ApiId" : { + "shape" : "Id", + "locationName" : "apiId", + "documentation" : "

The API identifier.

" + }, + "ApiMappingId" : { + "shape" : "Id", + "locationName" : "apiMappingId", + "documentation" : "

The API mapping identifier.

" + }, + "ApiMappingKey" : { + "shape" : "SelectionKey", + "locationName" : "apiMappingKey", + "documentation" : "

The API mapping key.

" + }, + "Stage" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "stage", + "documentation" : "

The API stage.

" + } + } + }, + "CreateApiRequest" : { + "type" : "structure", + "members" : { + "ApiKeySelectionExpression" : { + "shape" : "SelectionExpression", + "locationName" : "apiKeySelectionExpression", + "documentation" : "

An API key selection expression. See API Key Selection Expressions.

" + }, + "Description" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "description", + "documentation" : "

The description of the API.

" + }, + "DisableSchemaValidation" : { + "shape" : "__boolean", + "locationName" : "disableSchemaValidation", + "documentation" : "

Avoid validating models when creating a deployment.

" + }, + "Name" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "name", + "documentation" : "

The name of the API.

" + }, + "ProtocolType" : { + "shape" : "ProtocolType", + "locationName" : "protocolType", + "documentation" : "

The API protocol: Currently only WEBSOCKET is supported.

" + }, + "RouteSelectionExpression" : { + "shape" : "SelectionExpression", + "locationName" : "routeSelectionExpression", + "documentation" : "

The route selection expression for the API.

" + }, + "Version" : { + "shape" : "StringWithLengthBetween1And64", + "locationName" : "version", + "documentation" : "

A version identifier for the API.

" + } + }, + "required" : [ "RouteSelectionExpression", "ProtocolType", "Name" ] + }, + "CreateApiResponse" : { + "type" : "structure", + "members" : { + "ApiEndpoint" : { + "shape" : "__string", + "locationName" : "apiEndpoint", + "documentation" : "

The URI of the API, of the form {api-id}.execute-api.{region}.amazonaws.com. The\n stage name is typically appended to this URI to form a complete path to a deployed\n API stage.

" + }, + "ApiId" : { + "shape" : "Id", + "locationName" : "apiId", + "documentation" : "

The API ID.

" + }, + "ApiKeySelectionExpression" : { + "shape" : "SelectionExpression", + "locationName" : "apiKeySelectionExpression", + "documentation" : "

An API key selection expression. See API Key Selection Expressions.

" + }, + "CreatedDate" : { + "shape" : "__timestampIso8601", + "locationName" : "createdDate", + "documentation" : "

The timestamp when the API was created.

" + }, + "Description" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "description", + "documentation" : "

The description of the API.

" + }, + "DisableSchemaValidation" : { + "shape" : "__boolean", + "locationName" : "disableSchemaValidation", + "documentation" : "

Avoid validating models when creating a deployment.

" + }, + "Name" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "name", + "documentation" : "

The name of the API.

" + }, + "ProtocolType" : { + "shape" : "ProtocolType", + "locationName" : "protocolType", + "documentation" : "

The API protocol: Currently only WEBSOCKET is supported.

" + }, + "RouteSelectionExpression" : { + "shape" : "SelectionExpression", + "locationName" : "routeSelectionExpression", + "documentation" : "

The route selection expression for the API.

" + }, + "Version" : { + "shape" : "StringWithLengthBetween1And64", + "locationName" : "version", + "documentation" : "

A version identifier for the API.

" + }, + "Warnings" : { + "shape" : "__listOf__string", + "locationName" : "warnings", + "documentation" : "

The warning messages reported when failonwarnings is turned on during\n API import.

" + } + } + }, + "CreateAuthorizerInput" : { + "type" : "structure", + "members" : { + "AuthorizerCredentialsArn" : { + "shape" : "Arn", + "locationName" : "authorizerCredentialsArn", + "documentation" : "

" + }, + "AuthorizerResultTtlInSeconds" : { + "shape" : "IntegerWithLengthBetween0And3600", + "locationName" : "authorizerResultTtlInSeconds", + "documentation" : "

" + }, + "AuthorizerType" : { + "shape" : "AuthorizerType", + "locationName" : "authorizerType", + "documentation" : "

The authorizer type. Currently the only valid value is REQUEST, for a\n Lambda function using incoming request parameters.

" + }, + "AuthorizerUri" : { + "shape" : "UriWithLengthBetween1And2048", + "locationName" : "authorizerUri", + "documentation" : "

The authorizer's Uniform Resource Identifier (URI). For\n REQUEST authorizers, this must be a\n well-formed Lambda function URI, for example,\n 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.\n In general, the URI has this form:\n arn:aws:apigateway:{region}:lambda:path/{service_api}\n , where {region} is the same as the region hosting the Lambda\n function, path indicates that the remaining substring in the URI should be treated as\n the path to the resource, including the initial /. For Lambda functions,\n this is usually of the form\n /2015-03-31/functions/[FunctionARN]/invocations.

" + }, + "IdentitySource" : { + "shape" : "IdentitySourceList", + "locationName" : "identitySource", + "documentation" : "

The identity source for which authorization is requested.

" + }, + "IdentityValidationExpression" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "identityValidationExpression", + "documentation" : "

The\n validation expression does not apply to the REQUEST authorizer.

" + }, + "Name" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "name", + "documentation" : "

The name of the authorizer.

" + }, + "ProviderArns" : { + "shape" : "ProviderArnList", + "locationName" : "providerArns", + "documentation" : "

For\n REQUEST authorizer, this is not\n defined.

" + } + }, + "documentation" : "

Represents the input parameters for a CreateAuthorizer\n request.

", + "required" : [ "AuthorizerUri", "AuthorizerType", "IdentitySource", "Name" ] + }, + "CreateAuthorizerRequest" : { + "type" : "structure", + "members" : { + "ApiId" : { + "shape" : "__string", + "location" : "uri", + "locationName" : "apiId", + "documentation" : "

The API identifier.

" + }, + "AuthorizerCredentialsArn" : { + "shape" : "Arn", + "locationName" : "authorizerCredentialsArn", + "documentation" : "

" + }, + "AuthorizerResultTtlInSeconds" : { + "shape" : "IntegerWithLengthBetween0And3600", + "locationName" : "authorizerResultTtlInSeconds", + "documentation" : "

" + }, + "AuthorizerType" : { + "shape" : "AuthorizerType", + "locationName" : "authorizerType", + "documentation" : "

The authorizer type. Currently the only valid value is REQUEST, for a\n Lambda function using incoming request parameters.

" + }, + "AuthorizerUri" : { + "shape" : "UriWithLengthBetween1And2048", + "locationName" : "authorizerUri", + "documentation" : "

" + }, + "IdentitySource" : { + "shape" : "IdentitySourceList", + "locationName" : "identitySource", + "documentation" : "

The identity source for which authorization is requested.

" + }, + "IdentityValidationExpression" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "identityValidationExpression", + "documentation" : "

The\n validation expression does not apply to the REQUEST authorizer.

" + }, + "Name" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "name", + "documentation" : "

The name of the authorizer.

" + }, + "ProviderArns" : { + "shape" : "ProviderArnList", + "locationName" : "providerArns", + "documentation" : "

For\n REQUEST authorizer, this is not\n defined.

" + } + }, + "required" : [ "ApiId", "AuthorizerUri", "AuthorizerType", "IdentitySource", "Name" ] + }, + "CreateAuthorizerResponse" : { + "type" : "structure", + "members" : { + "AuthorizerCredentialsArn" : { + "shape" : "Arn", + "locationName" : "authorizerCredentialsArn", + "documentation" : "

" + }, + "AuthorizerId" : { + "shape" : "Id", + "locationName" : "authorizerId", + "documentation" : "

The authorizer identifier.

" + }, + "AuthorizerResultTtlInSeconds" : { + "shape" : "IntegerWithLengthBetween0And3600", + "locationName" : "authorizerResultTtlInSeconds", + "documentation" : "

" + }, + "AuthorizerType" : { + "shape" : "AuthorizerType", + "locationName" : "authorizerType", + "documentation" : "

The authorizer type. Currently the only valid value is REQUEST, for a\n Lambda function using incoming request parameters.

" + }, + "AuthorizerUri" : { + "shape" : "UriWithLengthBetween1And2048", + "locationName" : "authorizerUri", + "documentation" : "

" + }, + "IdentitySource" : { + "shape" : "IdentitySourceList", + "locationName" : "identitySource", + "documentation" : "

The identity source for which authorization is requested.

" + }, + "IdentityValidationExpression" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "identityValidationExpression", + "documentation" : "

The\n validation expression does not apply to the REQUEST authorizer.

" + }, + "Name" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "name", + "documentation" : "

The name of the authorizer.

" + }, + "ProviderArns" : { + "shape" : "ProviderArnList", + "locationName" : "providerArns", + "documentation" : "

For\n REQUEST authorizer, this is not\n defined.

" + } + } + }, + "CreateDeploymentInput" : { + "type" : "structure", + "members" : { + "Description" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "description", + "documentation" : "

The description for the deployment resource.

" + }, + "StageName" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "stageName", + "documentation" : "

The name of the Stage resource for the Deployment\n resource to create.

" + } + }, + "documentation" : "

Represents the input parameters for a CreateDeployment\n request.

" + }, + "CreateDeploymentRequest" : { + "type" : "structure", + "members" : { + "ApiId" : { + "shape" : "__string", + "location" : "uri", + "locationName" : "apiId", + "documentation" : "

The API identifier.

" + }, + "Description" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "description", + "documentation" : "

The description for the deployment resource.

" + }, + "StageName" : { + "shape" : "StringWithLengthBetween1And128", + "locationName" : "stageName", + "documentation" : "

The name of the Stage resource for the Deployment\n resource to create.

" + } + }, + "required" : [ "ApiId" ] + }, + "CreateDeploymentResponse" : { + "type" : "structure", + "members" : { + "CreatedDate" : { + "shape" : "__timestampIso8601", + "locationName" : "createdDate", + "documentation" : "

The date and time when the Deployment resource was created.

" + }, + "DeploymentId" : { + "shape" : "Id", + "locationName" : "deploymentId", + "documentation" : "

The identifier for the deployment.

" + }, + "DeploymentStatus" : { + "shape" : "DeploymentStatus", + "locationName" : "deploymentStatus", + "documentation" : "

The status of the deployment: PENDING, FAILED, or\n SUCCEEDED.

" + }, + "DeploymentStatusMessage" : { + "shape" : "__string", + "locationName" : "deploymentStatusMessage", + "documentation" : "

May contain additional feedback on the status of an API deployment.

" + }, + "Description" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "description", + "documentation" : "

The description for the deployment.

" + } + } + }, + "CreateDomainNameInput" : { + "type" : "structure", + "members" : { + "DomainName" : { + "shape" : "StringWithLengthBetween1And512", + "locationName" : "domainName", + "documentation" : "

The domain name.

" + }, + "DomainNameConfigurations" : { + "shape" : "DomainNameConfigurations", + "locationName" : "domainNameConfigurations", + "documentation" : "

The domain name configurations.

" + } + }, + "documentation" : "

Represents the input parameters for a CreateDomainName\n request.

", + "required" : [ "DomainName" ] + }, + "CreateDomainNameRequest" : { + "type" : "structure", + "members" : { + "DomainName" : { + "shape" : "StringWithLengthBetween1And512", + "locationName" : "domainName", + "documentation" : "

The domain name.

" + }, + "DomainNameConfigurations" : { + "shape" : "DomainNameConfigurations", + "locationName" : "domainNameConfigurations", + "documentation" : "

The domain name configurations.

" + } + }, + "required" : [ "DomainName" ] + }, + "CreateDomainNameResponse" : { + "type" : "structure", + "members" : { + "ApiMappingSelectionExpression" : { + "shape" : "SelectionExpression", + "locationName" : "apiMappingSelectionExpression", + "documentation" : "

The API mapping selection expression.

" + }, + "DomainName" : { + "shape" : "StringWithLengthBetween1And512", + "locationName" : "domainName", + "documentation" : "

The name of the DomainName resource.

" + }, + "DomainNameConfigurations" : { + "shape" : "DomainNameConfigurations", + "locationName" : "domainNameConfigurations", + "documentation" : "

The domain name configurations.

" + } + } + }, + "CreateIntegrationInput" : { + "type" : "structure", + "members" : { + "ConnectionId" : { + "shape" : "StringWithLengthBetween1And1024", + "locationName" : "connectionId", + "documentation" : "

The connection ID.

" + }, + "ConnectionType" : { + "shape" : "ConnectionType", + "locationName" : "connectionType", + "documentation" : "

The type of the network connection to the integration endpoint. Currently the only\n valid value is INTERNET, for connections through the public routable\n internet.

" + }, + "ContentHandlingStrategy" : { + "shape" : "ContentHandlingStrategy", + "locationName" : "contentHandlingStrategy", + "documentation" : "

Specifies how to handle response payload content type conversions. Supported\n values are CONVERT_TO_BINARY and CONVERT_TO_TEXT, with the\n following behaviors:

\n CONVERT_TO_BINARY: Converts a response payload from a Base64-encoded\n string to the corresponding binary blob.

\n CONVERT_TO_TEXT: Converts a response payload from a binary blob to a\n Base64-encoded string.

If this property is not defined, the response payload will be passed through from\n the integration response to the route response or method response without\n modification.

" + }, + "CredentialsArn" : { + "shape" : "Arn", + "locationName" : "credentialsArn", + "documentation" : "

Specifies the credentials required for the integration, if any. For AWS\n integrations, three options are available. To specify an IAM Role for API Gateway to\n assume, use the role's Amazon Resource Name (ARN). To require that the caller's\n identity be passed through from the request, specify the string\n arn:aws:iam::*:user/*. To use resource-based permissions on supported\n AWS services, specify null.

" + }, + "Description" : { + "shape" : "StringWithLengthBetween0And1024", + "locationName" : "description", + "documentation" : "

The description of the integration.

" + }, + "IntegrationMethod" : { + "shape" : "StringWithLengthBetween1And64", + "locationName" : "integrationMethod", + "documentation" : "

Specifies the integration's HTTP method type.

" + }, + "IntegrationType" : { + "shape" : "IntegrationType", + "locationName" : "integrationType", + "documentation" : "

The integration type of an integration. One of the following:

\n AWS: for integrating the route or method request with an AWS service\n action, including the Lambda function-invoking action. With the Lambda\n function-invoking action, this is referred to as the Lambda custom integration. With\n any other AWS service action, this is known as AWS integration.

\n AWS_PROXY: for integrating the route or method request with the Lambda\n function-invoking action with the client request passed through as-is. This\n integration is also referred to as Lambda proxy integration.

\n HTTP: for integrating the route or method request with an HTTP\n endpoint. This\n integration is also referred to as HTTP custom integration.

\n HTTP_PROXY: for integrating route or method request with an HTTP\n endpoint, with the client\n request passed through as-is. This is also referred to as HTTP proxy\n integration.

\n MOCK: for integrating the route or method request with API Gateway as a\n \"loopback\" endpoint without invoking any backend.

" + }, + "IntegrationUri" : { + "shape" : "UriWithLengthBetween1And2048", + "locationName" : "integrationUri", + "documentation" : "

For a Lambda proxy integration, this is the URI of the Lambda function.

" + }, + "PassthroughBehavior" : { + "shape" : "PassthroughBehavior", + "locationName" : "passthroughBehavior", + "documentation" : "

Specifies the pass-through behavior for incoming requests based on the\n Content-Type header in the request, and the available mapping\n templates specified as the requestTemplates property on the\n Integration resource. There are three valid values:\n WHEN_NO_MATCH, WHEN_NO_TEMPLATES, and\n NEVER.

\n WHEN_NO_MATCH passes the request body for unmapped content types through\n to the integration backend without transformation.

\n NEVER rejects unmapped content types with an HTTP 415 Unsupported\n Media Type response.

\n WHEN_NO_TEMPLATES allows pass-through when the integration has no\n content types mapped to templates. However, if there is at least one content type\n defined, unmapped content types will be rejected with the same HTTP 415\n Unsupported Media Type response.

" + }, + "RequestParameters" : { + "shape" : "IntegrationParameters", + "locationName" : "requestParameters", + "documentation" : "

A key-value map specifying request parameters that are passed from the method\n request to the backend. The key is an integration request parameter name and the\n associated value is a method request parameter value or static value that must be\n enclosed within single quotes and pre-encoded as required by the backend. The method\n request parameter value must match the pattern of\n method.request.{location}.{name}\n , where \n {location}\n is querystring, path, or header; and \n {name}\n must be a valid and unique method request parameter name.

" + }, + "RequestTemplates" : { + "shape" : "TemplateMap", + "locationName" : "requestTemplates", + "documentation" : "

Represents a map of Velocity templates that are applied on the request payload\n based on the value of the Content-Type header sent by the client. The content type\n value is the key in this map, and the template (as a String) is the value.

" + }, + "TemplateSelectionExpression" : { + "shape" : "SelectionExpression", + "locationName" : "templateSelectionExpression", + "documentation" : "

The template selection expression for the integration.

" + }, + "TimeoutInMillis" : { + "shape" : "IntegerWithLengthBetween50And29000", + "locationName" : "timeoutInMillis", + "documentation" : "

Custom timeout between 50 and 29,000 milliseconds. The default value is 29,000\n milliseconds or 29 seconds.

" + } + }, + "documentation" : "

Represents the input parameters for a CreateIntegration\n request.

", + "required" : [ "IntegrationType" ] + }, + "CreateIntegrationRequest" : { + "type" : "structure", + "members" : { + "ApiId" : { + "shape" : "__string", + "location" : "uri", + "locationName" : "apiId", + "documentation" : "

The API identifier.

" + }, + "ConnectionId" : { + "shape" : "StringWithLengthBetween1And1024", + "locationName" : "connectionId", + "documentation" : "