Metadata-Version: 2.1
Name: c7n-azure
Version: 0.7.23
Summary: Cloud Custodian - Azure Support
Home-page: https://cloudcustodian.io
License: Apache-2.0
Author: Cloud Custodian Project
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: System :: Distributed Computing
Classifier: Topic :: System :: Systems Administration
Requires-Dist: adal (==1.2.7)
Requires-Dist: applicationinsights (==0.11.10)
Requires-Dist: apscheduler (==3.10.1)
Requires-Dist: azure-cosmos (==3.2.0)
Requires-Dist: azure-cosmosdb-table (==1.0.6)
Requires-Dist: azure-functions (==1.13.3);  python_version >= "3" and python_version < "4"
Requires-Dist: azure-graphrbac (==0.61.1)
Requires-Dist: azure-identity (==1.12.0)
Requires-Dist: azure-keyvault (==4.2.0)
Requires-Dist: azure-keyvault-certificates (==4.6.0)
Requires-Dist: azure-keyvault-keys (==4.7.0)
Requires-Dist: azure-keyvault-secrets (==4.6.0)
Requires-Dist: azure-mgmt-advisor (==9.0.0)
Requires-Dist: azure-mgmt-apimanagement (==1.0.0)
Requires-Dist: azure-mgmt-applicationinsights (==1.0.0)
Requires-Dist: azure-mgmt-authorization (==1.0.0)
Requires-Dist: azure-mgmt-batch (==15.0.0)
Requires-Dist: azure-mgmt-cdn (==10.0.0)
Requires-Dist: azure-mgmt-cognitiveservices (==11.0.0)
Requires-Dist: azure-mgmt-compute (==19.0.0)
Requires-Dist: azure-mgmt-containerinstance (==7.0.0)
Requires-Dist: azure-mgmt-containerregistry (==8.0.0b1)
Requires-Dist: azure-mgmt-containerservice (==15.1.0)
Requires-Dist: azure-mgmt-cosmosdb (==6.4.0)
Requires-Dist: azure-mgmt-costmanagement (==1.0.0)
Requires-Dist: azure-mgmt-databricks (==1.0.0b1)
Requires-Dist: azure-mgmt-datafactory (==1.1.0)
Requires-Dist: azure-mgmt-datalake-store (==0.5.0)
Requires-Dist: azure-mgmt-dns (==8.0.0b1)
Requires-Dist: azure-mgmt-eventgrid (==8.0.0)
Requires-Dist: azure-mgmt-eventhub (==8.0.0)
Requires-Dist: azure-mgmt-frontdoor (==1.0.1)
Requires-Dist: azure-mgmt-hdinsight (==7.0.0)
Requires-Dist: azure-mgmt-iothub (==1.0.0)
Requires-Dist: azure-mgmt-keyvault (==8.0.0)
Requires-Dist: azure-mgmt-logic (==9.0.0)
Requires-Dist: azure-mgmt-managementgroups (==1.0.0b1)
Requires-Dist: azure-mgmt-monitor (==2.0.0)
Requires-Dist: azure-mgmt-msi (==1.0.0)
Requires-Dist: azure-mgmt-network (==17.1.0)
Requires-Dist: azure-mgmt-policyinsights (==1.0.0)
Requires-Dist: azure-mgmt-rdbms (==8.1.0)
Requires-Dist: azure-mgmt-redis (==12.0.0)
Requires-Dist: azure-mgmt-resource (==16.1.0)
Requires-Dist: azure-mgmt-resourcegraph (==7.0.0)
Requires-Dist: azure-mgmt-search (==8.0.0)
Requires-Dist: azure-mgmt-security (==1.0.0)
Requires-Dist: azure-mgmt-servicefabric (==1.0.0)
Requires-Dist: azure-mgmt-sql (==1.0.0)
Requires-Dist: azure-mgmt-storage (==17.1.0)
Requires-Dist: azure-mgmt-subscription (==1.0.0)
Requires-Dist: azure-mgmt-trafficmanager (==0.51.0)
Requires-Dist: azure-mgmt-web (==2.0.0)
Requires-Dist: azure-storage-blob (==12.15.0)
Requires-Dist: azure-storage-file (==2.1.0)
Requires-Dist: azure-storage-file-share (==12.11.0)
Requires-Dist: azure-storage-queue (==12.6.0)
Requires-Dist: click (==8.1.3)
Requires-Dist: cryptography (==39.0.2)
Requires-Dist: distlib (==0.3.6)
Requires-Dist: jmespath (==1.0.1)
Requires-Dist: netaddr (==0.7.20)
Requires-Dist: requests (==2.28.2)
Project-URL: Documentation, https://cloudcustodian.io/docs/
Project-URL: Repository, https://github.com/cloud-custodian/cloud-custodian
Description-Content-Type: text/markdown
Requires-Dist: c7n (==0.9.24)


# Cloud Custodian - Azure Support

This a plugin to Cloud Custodian that adds Azure support.

## Install Cloud Custodian and Azure Plugin

The Azure provider must be installed as a separate package in addition to c7n. 

    $ git clone https://github.com/cloud-custodian/cloud-custodian.git
    $ virtualenv custodian
    $ source custodian/bin/activate
    (custodian) $ pip install -e cloud-custodian/.
    (custodian) $ pip install -e cloud-custodian/tools/c7n_azure/.


## Write your first policy

A policy specifies the following items:

- The type of resource to run the policy against
- Filters to narrow down the set of resources
- Actions to take on the filtered set of resources

For this tutorial we will add a tag to all virtual machines with the name "Hello" and the value "World".

Create a file named ``custodian.yml`` with this content:

    policies:
        - name: my-first-policy
          description: |
            Adds a tag to all virtual machines
          resource: azure.vm
          actions:
            - type: tag
              tag: Hello
              value: World

## Run your policy

First, choose one of the supported authentication mechanisms and either log in to Azure CLI or set
environment variables as documented in [Authentication](https://cloudcustodian.io/docs/azure/authentication.html#azure-authentication).

    custodian run --output-dir=. custodian.yml


If successful, you should see output similar to the following on the command line

    2016-12-20 08:35:06,133: custodian.policy:INFO Running policy my-first-policy resource: azure.vm
    2016-12-20 08:35:07,514: custodian.policy:INFO policy: my-first-policy resource:azure.vm has count:1 time:1.38
    2016-12-20 08:35:08,188: custodian.policy:INFO policy: my-first-policy action: tag: 1 execution_time: 0.67


You should also find a new ``my-first-policy`` directory with a log and other
files (subsequent runs will append to the log by default rather than
overwriting it). 

## Links
- [Getting Started](https://cloudcustodian.io/docs/azure/gettingstarted.html)
- [Example Scenarios](https://cloudcustodian.io/docs/azure/examples/index.html)
- [Example Policies](https://cloudcustodian.io/docs/azure/policy/index.html)





