Metadata-Version: 2.1
Name: aws-default-cleaner
Version: 1.0.2
Summary: AWS Default Cleaner - default VPC, default subnets, default internet gateway and etc
Home-page: https://github.com/ashkue/aws-default-cleaner
Author: Pavel Morshenyuk
Author-email: ashkue@outlook.com
License: MIT
Description: # Introduction
        
        `aws-default-cleaner` is a command line tool to delete default VPCs, subnets and internet gateways from your AWS account
        
        # Installation
        
        Install package using [pip](https://pypi.org/project/aws-default-cleaner/) package-manager
        
        ``` shell
        pip install aws-default-cleaner
        ```
        
        # Usage
        
        ## Basic usage
        
        Currently this tool supports two operations: `discover` and `delete`.
        
        - `discover` command searches for default VPCs in the AWS account and outputs VPC ids (no objects deleted)
        - `delete` command tries to delete default VPCs and associated subnets and internet gateways
        
        Example:
        ``` shell
        aws-default-cleaner discover
        aws-default-cleaner delete
        ```
        
        ## Assuming role
        
        When you use multi-account setup with central IAM account and specific roles in spoke accounts, you can force `aws-default-cleaner` to assume role before performing any operations. Simply supply one or more `--assume` or `-a` flags with the corresponding role names.
        
        Example:
        ``` shell
        aws-default-cleaner discover -a arn:aws:iam::account-one-id:role/infra-admin-assumerole -a arn:aws:iam::account-two-id:role/infra-admin-assumerole
        aws-default-cleaner delete -a arn:aws:iam::XXXXXXXXXXXX:role/infra-admin-assumerole
        ```
        
        ## Region filtering
        
        By default `aws-default-cleaner` will search for the default resources in the all available regions, but you can override this behavior by supplying `--assume` or `-a` flags.
        
        Example:
        ``` shell
        aws-default-cleaner discover -r eu-central-1 -r eu-west-3
        aws-default-cleaner delete -r eu-central-1 -r eu-west-3
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
