get aws regions package

Aperçu

Ce module fournit une méthode simple pour récupérer et traiter les informations de la région AWS. Il s'agit d'un composant central pour tous les outils de notre boîte à outils AWS.

Caractéristiques

• Récupérer les régions AWS :

  • Récupérez une liste de toutes les régions AWS, incluant éventuellement / excluant les régions en fonction du statut d'opt-in de compte.
  • Prend en charge la récupération d'informations détaillées sur chaque région.

• Détails de la région :

  • Répondez des descriptions d'emplacement géographique pour des régions AWS spécifiques du magasin de paramètres AWS Systems Manager (SSM).
  • Utilise du threading simultané pour des performances améliorées lors de la récupération de plusieurs détails de région.

• Filtrage :

  • Appliquer, inclure et exclure les filtres pour personnaliser la liste des régions AWS renvoyées.

Fonctions

Fonctions publiques

• get_region_list
  • Récupère une liste des régions AWS.
  • Paramètres:
    • include_list : Liste facultative des régions à inclure.
    • exclude_list : Liste facultative des régions à exclure.
    • all_regions : Flag booléen pour inclure toutes les régions (par défaut: true).
    • details : Flag booléen pour retourner des informations détaillées sur chaque région (par défaut: false).
    • profile_name : chaîne pour spécifier le nom du profil à utiliser.
  • Renvoie:
    • Si details=True : Liste triée des dictionnaires contenant des informations détaillées sur la région.
    • Si details=False : la liste triée des noms de région sous forme de chaînes.
  • Augmentation:
    • RegionListingError : Si une erreur se produit pendant la récupération de la région ou le traitement.

Usage

Ce module est conçu pour être utilisé dans le cadre du package wolfsoftware.get-aws-regions . La fonction principale, get_region_list , permet de récupérer flexible et de personnaliser les informations de la région AWS en fonction des critères définis par l'utilisateur.

Exemple

 from wolfsoftware . get_aws_regions import get_region_list

# Example usage: Retrieve all regions and print their names
regions = get_region_list ( details = False )
print ( "AWS Regions:" , regions )

# Example usage: Retrieve detailed information for selected regions
detailed_regions = get_region_list ( include_list = [ 'us-west-1' , 'us-east-1' ], details = True )
for region in detailed_regions :
    print ( f"Region: { region [ 'RegionName' ] } , Location: { region [ 'GeographicalLocation' ] } " )

Notes

• Assurez-vous que les informations d'identification AWS sont correctement configurées pour l'accès à l'API.
• La gestion des erreurs est intégrée pour gérer les exceptions pendant les opérations AWS.
• Le filetage est utilisé pour des opérations concurrentes efficaces lors de la récupération des détails de la région.

Pour plus de détails et d'options de personnalisation, reportez-vous aux docstrings de fonction et à l'implémentation du module.