VhWdZdZdZddlZddlZ ddlZddlmZddl m Z ddl m Z ddl mZejd Zd Zd Zd Zd ZdZdZdZdZdZedk(reyy#e$rY_wxYw)a^ --- module: lambda_info version_added: 5.0.0 short_description: Gathers AWS Lambda function details description: - Gathers various details related to Lambda functions, including aliases, versions and event source mappings. - Use module M(amazon.aws.lambda) to manage the lambda function itself, M(amazon.aws.lambda_alias) to manage function aliases, M(amazon.aws.lambda_event) to manage lambda event source mappings, and M(amazon.aws.lambda_policy) to manage policy statements. - This module was originally added to C(community.aws) in release 1.0.0. options: query: description: - Specifies the resource type for which to gather information. - Defaults to V(all) when O(function_name) is specified. - Defaults to V(config) when O(function_name) is NOT specified. choices: [ "aliases", "all", "config", "mappings", "policy", "versions", "tags" ] type: str function_name: description: - The name of the lambda function for which information is requested. aliases: [ "function", "name"] type: str event_source_arn: description: - When O(query=mappings), this is the Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream. type: str author: - Pierre Jodouin (@pjodouin) extends_documentation_fragment: - amazon.aws.common.modules - amazon.aws.region.modules - amazon.aws.boto3 a --- # Simple example of listing all info for a function - name: List all for a specific function amazon.aws.lambda_info: query: all function_name: myFunction register: my_function_details # Get basic information about AWS Lambda Functions in the current region - name: List Lambda Functions amazon.aws.lambda_info: register: lambda_functions # List all versions of a function - name: List function versions amazon.aws.lambda_info: query: versions function_name: myFunction register: my_function_versions # List all info for all functions - name: List all functions amazon.aws.lambda_info: query: all register: output - name: show Lambda information ansible.builtin.debug: msg: "{{ output['function'] }}" a& --- function: description: - Lambda function list. - RV(function) has been deprecated in will be removed in the next major release after 2025-01-01. returned: success type: dict function.TheName: description: - Lambda function information, including event, mapping, and version information. - RV(function) has been deprecated in will be removed in the next major release after 2025-01-01. returned: success type: dict functions: description: List of information for each lambda function matching the query. returned: always type: list elements: dict version_added: 4.1.0 version_added_collection: community.aws contains: aliases: description: The aliases associated with the function. returned: when O(query=aliases) or O(query=all) type: list elements: str architectures: description: The architectures supported by the function. returned: success type: list elements: str sample: ['arm64'] code_sha256: description: The SHA256 hash of the function's deployment package. returned: success type: str sample: 'zOAGfF5JLFuzZoSNirUtOrQp+S341IOA3BcoXXoaIaU=' code_size: description: The size of the function's deployment package in bytes. returned: success type: int sample: 123 dead_letter_config: description: The function's dead letter queue. returned: when the function has a dead letter queue configured type: dict sample: { 'target_arn': arn:aws:lambda:us-east-1:123456789012:function:myFunction:1 } contains: target_arn: description: The ARN of an SQS queue or SNS topic. returned: when the function has a dead letter queue configured type: str sample: arn:aws:lambda:us-east-1:123456789012:function:myFunction:1 description: description: The function's description. returned: success type: str sample: 'My function' ephermal_storage: description: The size of the function /tmp directory in MB. type: dict contains: size: description: The size of the function /tmp directory. type: int returned: always sample: 512 environment: description: The function's environment variables. returned: when environment variables exist type: dict contains: variables: description: Environment variable key-value pairs. returned: when environment variables exist type: dict sample: {'key': 'value'} error: description: Error message for environment variables that could not be applied. returned: when there is an error applying environment variables type: dict contains: error_code: description: The error code. returned: when there is an error applying environment variables type: str message: description: The error message. returned: when there is an error applying environment variables type: str function_arn: description: The function's Amazon Resource Name (ARN). returned: on success type: str sample: 'arn:aws:lambda:us-east-1:123456789012:function:myFunction:1' function_name: description: The function's name. returned: on success type: str sample: 'myFunction' handler: description: The function Lambda calls to begin executing your function. returned: on success type: str sample: 'index.handler' last_modified: description: The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ssTZD). returned: on success type: str sample: '2017-08-01T00:00:00.000+0000' mappings: description: List of configuration information for each event source mapping. returned: when O(query=all) or O(query=mappings) type: list elements: dict contains: uuid: description: The AWS Lambda assigned opaque identifier for the mapping. returned: on success type: str batch_size: description: The largest number of records that AWS Lambda will retrieve from the event source at the time of invoking the function. returned: on success type: int event_source_arn: description: The ARN of the Amazon Kinesis or DyanmoDB stream that is the source of events. returned: on success type: str function_arn: description: The Lambda function to invoke when AWS Lambda detects an event on the poll-based source. returned: on success type: str last_modified: description: The UTC time string indicating the last time the event mapping was updated. returned: on success type: str last_processing_result: description: The result of the last AWS Lambda invocation of your Lambda function. returned: on success type: str state: description: The state of the event source mapping. returned: on success type: str state_transition_reason: description: The reason the event source mapping is in its current state. returned: on success type: str memory_size: description: The memory allocated to the function. returned: on success type: int sample: 128 package_type: description: The type of deployment package. type: str returned: always sample: "Zip" policy: description: The policy associated with the function. returned: when O(query=all) or O(query=policy) type: dict revision_id: description: The latest updated revision of the function or alias. returned: on success type: str sample: 'a2x9886d-d48a-4a0c-ab64-82abc005x80c' role: description: The function's execution role. returned: on success type: str sample: 'arn:aws:iam::123456789012:role/lambda_basic_execution' runtime: description: The funtime environment for the Lambda function. returned: on success type: str sample: 'nodejs6.10' runtime_version_config: description: The ARN of the runtime and any errors that occured. type: dict contains: runtime_version_arn: description: The ARN of the runtime version you want the function to use. type: str returned: always sample: "arn:aws:lambda:us-west-2::runtime:123456789012" snap_start: description: Snapshot of the initialized execution environment when you publish a function version. type: dict contains: apply_on: description: When set to V(PublishedVersions), Lambda creates a snapshot of the execution environment when you publish a function version. type: str sample: "None" returned: always optimization_status: description: This element indicates whether SnapStart is activated for the specified function version. type: str returned: always sample: "Off" tracing_config: description: The function's AWS X-Ray tracing configuration. returned: on success type: dict sample: { 'mode': 'Active' } contains: mode: description: The tracing mode. returned: on success type: str sample: 'Active' timeout: description: The amount of time that Lambda allows a function to run before terminating it. returned: on success type: int sample: 3 version: description: The version of the Lambda function. returned: on success type: str sample: '1' versions: description: List of Lambda function versions. returned: when O(query=all) or O(query=versions) type: list elements: dict vpc_config: description: The function's networking configuration. returned: on success type: dict sample: { 'security_group_ids': [], 'subnet_ids': [], 'vpc_id': '123' } N)camel_dict_to_snake_dict)is_boto3_error_code)AnsibleAWSModule)AWSRetryc d|j|}|jdi|jS)N) get_paginatorpaginatebuild_full_result)clientfunctionparams paginators j/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/amazon/aws/plugins/modules/lambda_info.py _paginaterGs1$$X.I 9   ' ' 9 9 ;;ct} |jt|d|dt|S#td$r|jgYt|Stj j tj jf$r'}|j|dYd}~t|Sd}~wwxYw) z Returns list of aliases for a specified function. :param client: AWS API client reference (boto3) :param module: Ansible module reference :param function_name (str): Name of Lambda function to query :return dict: list_aliases FunctionNameAliases)aliasesResourceNotFoundExceptionzTrying to get aliasesmsgN dictupdaterrbotocore exceptions ClientError BotoCoreError fail_json_awsrr module function_name lambda_infoes r alias_detailsr)Ms&K=9V^R_#`aj#kl $K 00 : ;'2& $K 00 '')) = Q$;<< #K 00 =s!8 C$6CB<<Cc|r|S|ryy)Nallconfigr)queryr&s r _get_queryr.fs   rc|jjd}|r|g}n!t|dd}|Dcgc]}|d }}t|jd|}g}i}|D]}i} | j t ||||dvr| j t ||||dvr| j t||||dvr| j t||||d vr| j t||||d vr| j t|||| || d<|j| |j||d y cc}w)z Returns queried facts for a specified function (or all functions). :param client: AWS API client reference (boto3) :param module: Ansible module reference r&list_functions Functionsrr-)r+r)r+policy)r+versions)r+mappings)r+tagsF)r functionschangedN) rgetrr.rconfig_detailsr)policy_detailsversion_detailsmapping_details tags_detailsappend exit_json) r r%r&function_namesall_function_info function_infor-r6 all_factsr s rr0r0qsmMM%%o6M'&f.>? LM^_M-7__ v}}W-} =EII'#  vv}EF & & OOM&&-H I % % OON66=I J ' ' OOOFFMJ K ' ' OOOFFMJ K O # OOLG H/7 (?+, "3#8 i9eLI`s Ect} |j|jd|d |vr$d |d vr|d d }t|}||d d <|St|}|S#td$r|jiYWtj j tj jf$r!}|j|d|dYd}~d}~wwxYw) z Returns configuration details for a lambda function. :param client: AWS API client reference (boto3) :param module: Ansible module reference :param function_name (str): Name of Lambda function to query :return dict: T aws_retryrrr Trying to get z configurationrN Environment Variables environment variables) rrget_function_configurationrrr r!r"r#r)r r%r&r'r(env_varssnaked_lambda_infos rr9r9s&KT6<$RSS Ts"A## C6C;CCct}t}||d<|jjdr|jjd|d< |jt |dfi|dt|S#t d$r|jgYt|St jjt jjf$r'}|j|d Yd }~t|Sd }~wwxYw) z Returns all lambda event source mappings. :param client: AWS API client reference (boto3) :param module: Ansible module reference :param function_name (str): Name of Lambda function to query :return dict: revent_source_arnEventSourceArnlist_event_source_mappingsEventSourceMappings)r4rz#Trying to get source event mappingsrN) rrr8rrrrr r!r"r#r)r r%r&r'rr(s rr<r<s&K VF*F> }}+,#)==#4#45G#H KIf6R$]V\$]^s$tu $K 00 : ;(B' $K 00 '')) K Q$IJJ #K 00 Ks A?? D+6D!DDct} |jtj|j d|dt|S#t d$r|jiYt|St jjt jjf$r+}|j|d|dYd }~t|Sd }~wwxYw) z Returns policy attached to a lambda function. :param client: AWS API client reference (boto3) :param module: Ansible module reference :param function_name (str): Name of Lambda function to query :return dict: TrEPolicy)r2rrHz policyrN) rrjsonloads get_policyrrr r!r"r#rr$s rr:r:s&K M$**V->->\i->-jks-t"uv $K 00 : ;&"% $K 00 '')) M Qn]O7$KLL #K 00 Ms9A C<6C2CCct} |jt|d|dt|S#td$r|jgYt|Stj j tj jf$r+}|j|d|dYd }~t|Sd }~wwxYw) z Returns all lambda function versions. :param client: AWS API client reference (boto3) :param module: Ansible module reference :param function_name (str): Name of Lambda function to query :return dict: list_versions_by_functionrVersions)r3rrHz versionsrNrr$s rr;r;s&K Ov'BQ^_`jk   $K 00 : ;(B' $K 00 '')) O Qn]O9$MNN #K 00 Os!8 C$6CCCct} |j|jd|jdit|S#t d$r|jiYt|St j jt j jf$r+}|j|d|d Yd }~t|Sd }~wwxYw) z Returns tag details for a lambda function. :param client: AWS API client reference (boto3) :param module: Ansible module reference :param function_name (str): Name of Lambda function to query :return dict: TrETags)r5rrGrHz tagsrN) rr get_functionr8rrr r!r"r#rr$s rr=r=s&KK 3 3dQ^ 3 _ c cdjln op $K 00 : ;(B' $K 00 '')) K Qn]O5$IJJ #K 00 Ks3A C66C,CCcttddddgtdgddtdd }t|d gg }|jd }|rPtjd |s|j d|dt |dkDr|j d|d|jdtj}|jdddt||y)z< Main entry point. :return dict: ansible facts FNr name)requireddefaultr)rr+r,r4r2r3r5)rbchoicesrc)rbrc)r&r-rQT) argument_specsupports_check_modemutually_exclusiverequired_togetherr&z ^[\w\-:]+$zFunction name zI is invalid. Names must contain only alphanumeric characters and hyphens.r@zFunction name "z" exceeds 64 character limitlambda)retry_decoratorzThe returned key 'function', which returned a dictionary of dictionaries, is deprecated and will be replaced by 'functions', which returns a list of dictionaries. Both keys are returned for now.z 2025-01-01z amazon.aws)datecollection_name) rrrresearch fail_jsonlenr rjittered_backoff deprecater0)rer%r&r s rmainrt5s E4*fAUV$jtx ud; M#RThjF MM/2Myy 6   $]O3|}   }  "   ?=/A]!^  _ ]]8X5N5N5P] QF  n$ 66"r__main__) DOCUMENTATIONEXAMPLESRETURNrWrnr ImportError0ansible.module_utils.common.dict_transformationsrrs! F @l \  V\XP<< 124Mn@1>141612(#V zFG   sA,,A43A4