--- title: Check that an AWS Lambda Function exists description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > AWS Logs Integration --- # Check that an AWS Lambda Function exists{% #check-that-an-aws-lambda-function-exists %} {% tab title="v1" %} | Datadog site | API endpoint | | ----------------- | -------------------------------------------------------------------------- | | ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/integration/aws/logs/check_async | | ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/integration/aws/logs/check_async | | app.datadoghq.eu | POST https://api.datadoghq.eu/api/v1/integration/aws/logs/check_async | | app.ddog-gov.com | POST https://api.ddog-gov.com/api/v1/integration/aws/logs/check_async | | us2.ddog-gov.com | POST https://api.us2.ddog-gov.com/api/v1/integration/aws/logs/check_async | | app.datadoghq.com | POST https://api.datadoghq.com/api/v1/integration/aws/logs/check_async | | us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/integration/aws/logs/check_async | | us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/integration/aws/logs/check_async | ### Overview Test if permissions are present to add a log-forwarding triggers for the given services and AWS account. The input is the same as for Enable an AWS service log collection. Subsequent requests will always repeat the above, so this endpoint can be polled intermittently instead of blocking. - Returns a status of 'created' when it's checking if the Lambda exists in the account. - Returns a status of 'waiting' while checking. - Returns a status of 'checked and ok' if the Lambda exists. - Returns a status of 'error' if the Lambda does not exist. This endpoint requires the `aws_configuration_read` permission. ### Request #### Body Data (required) Check AWS Log Lambda Async request body. {% tab title="Model" %} | Field | Type | Description | | ---------------------------- | ------ | ---------------------------------------------------------------------------------------------- | | account_id [*required*] | string | Your AWS Account ID without dashes. | | lambda_arn [*required*] | string | ARN of the Datadog Lambda created during the Datadog-Amazon Web services Log collection setup. | {% /tab %} {% tab title="Example" %} ```json { "account_id": "1234567", "lambda_arn": "arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest" } ``` {% /tab %} ### Response {% tab title="200" %} OK {% tab title="Model" %} A list of all Datadog-AWS logs integrations available in your Datadog organization. | Parent field | Field | Type | Description | | ------------ | ------- | -------- | ------------------------- | | | errors | [object] | List of errors. | | errors | code | string | Code properties | | errors | message | string | Message content. | | | status | string | Status of the properties. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ { "code": "no_such_config", "message": "AWS account 12345 has no Lambda config to update" } ], "status": "created" } ``` {% /tab %} {% /tab %} {% tab title="400" %} Bad Request {% tab title="Model" %} Error response object. | Field | Type | Description | | ------------------------ | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="403" %} Authentication Error {% tab title="Model" %} Error response object. | Field | Type | Description | | ------------------------ | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} Error response object. | Field | Type | Description | | ------------------------ | -------- | ------------------------------------ | | errors [*required*] | [string] | Array of errors returned by the API. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \## default # \# Curl command curl -X POST "https://api.datadoghq.com/api/v1/integration/aws/logs/check_async" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \ -d @- << EOF { "account_id": "1234567", "lambda_arn": "arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest" } EOF ##### ```python """ Check that an AWS Lambda Function exists returns "OK" response """ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v1.api.aws_logs_integration_api import AWSLogsIntegrationApi from datadog_api_client.v1.model.aws_account_and_lambda_request import AWSAccountAndLambdaRequest body = AWSAccountAndLambdaRequest( account_id="1234567", lambda_arn="arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest", ) configuration = Configuration() with ApiClient(configuration) as api_client: api_instance = AWSLogsIntegrationApi(api_client) response = api_instance.check_aws_logs_lambda_async(body=body) print(response) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" python3 "example.py" ##### ```ruby # Check that an AWS Lambda Function exists returns "OK" response require "datadog_api_client" api_instance = DatadogAPIClient::V1::AWSLogsIntegrationAPI.new body = DatadogAPIClient::V1::AWSAccountAndLambdaRequest.new({ account_id: "1234567", lambda_arn: "arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest", }) p api_instance.check_aws_logs_lambda_async(body) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" rb "example.rb" ##### ```ruby require 'rubygems' require 'dogapi' api_key = '' app_key = '' dog = Dogapi::Client.new(api_key, app_key) config = { "account_id": '', "lambda_arn": 'arn:aws:lambda:::function:' } dog.aws_logs_check_lambda(config) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby-legacy) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" rb "example.rb" ##### ```go // Check that an AWS Lambda Function exists returns "OK" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV1" ) func main() { body := datadogV1.AWSAccountAndLambdaRequest{ AccountId: "1234567", LambdaArn: "arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest", } ctx := datadog.NewDefaultContext(context.Background()) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV1.NewAWSLogsIntegrationApi(apiClient) resp, r, err := api.CheckAWSLogsLambdaAsync(ctx, body) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `AWSLogsIntegrationApi.CheckAWSLogsLambdaAsync`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `AWSLogsIntegrationApi.CheckAWSLogsLambdaAsync`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" go run "main.go" ##### ```java // Check that an AWS Lambda Function exists returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v1.api.AwsLogsIntegrationApi; import com.datadog.api.client.v1.model.AWSAccountAndLambdaRequest; import com.datadog.api.client.v1.model.AWSLogsAsyncResponse; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); AwsLogsIntegrationApi apiInstance = new AwsLogsIntegrationApi(defaultClient); AWSAccountAndLambdaRequest body = new AWSAccountAndLambdaRequest() .accountId("1234567") .lambdaArn("arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest"); try { AWSLogsAsyncResponse result = apiInstance.checkAWSLogsLambdaAsync(body); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling AwsLogsIntegrationApi#checkAWSLogsLambdaAsync"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" java "Example.java" ##### ```python from datadog import initialize, api options = { 'api_key': '', 'app_key': '' } initialize(**options) account_id = "" lambda_arn = "arn:aws:lambda:::function:" api.AwsLogsIntegration.check_lambda(account_id=account_id, lambda_arn=lambda_arn) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python-legacy) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" python "example.py" ##### ```rust // Check that an AWS Lambda Function exists returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV1::api_aws_logs_integration::AWSLogsIntegrationAPI; use datadog_api_client::datadogV1::model::AWSAccountAndLambdaRequest; #[tokio::main] async fn main() { let body = AWSAccountAndLambdaRequest::new( "1234567".to_string(), "arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest".to_string(), ); let configuration = datadog::Configuration::new(); let api = AWSLogsIntegrationAPI::with_config(configuration); let resp = api.check_aws_logs_lambda_async(body).await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ##### ```typescript /** * Check that an AWS Lambda Function exists returns "OK" response */ import { client, v1 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration(); const apiInstance = new v1.AWSLogsIntegrationApi(configuration); const params: v1.AWSLogsIntegrationApiCheckAWSLogsLambdaAsyncRequest = { body: { accountId: "1234567", lambdaArn: "arn:aws:lambda:us-east-1:1234567:function:LogsCollectionAPITest", }, }; apiInstance .checkAWSLogsLambdaAsync(params) .then((data: v1.AWSLogsAsyncResponse) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" tsc "example.ts" {% /tab %}