--- title: Crear tarea AWS bajo demanda description: Activa el escaneado de un recurso de AWS con una prioridad alta. breadcrumbs: Documentación > API > Crear tarea AWS bajo demanda --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt). # Crear tarea AWS bajo demanda {% callout %} This product or feature is not supported for the following sites: app.ddog-gov.com, us2.ddog-gov.com {% /callout %} ## v2 (latest) | Datadog site | API endpoint | | ----------------- | ------------------------------------------------------------------------- | | app.datadoghq.com | POST https://api.datadoghq.com/api/v2/agentless_scanning/ondemand/aws | | us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/agentless_scanning/ondemand/aws | | us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/agentless_scanning/ondemand/aws | | app.datadoghq.eu | POST https://api.datadoghq.eu/api/v2/agentless_scanning/ondemand/aws | | ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/agentless_scanning/ondemand/aws | | ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/agentless_scanning/ondemand/aws | | uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/agentless_scanning/ondemand/aws | | app.ddog-gov.com | POST https://api.ddog-gov.com/api/v2/agentless_scanning/ondemand/aws | | us2.ddog-gov.com | POST https://api.us2.ddog-gov.com/api/v2/agentless_scanning/ondemand/aws | ### Overview Activa el escaneado de un recurso de AWS con una prioridad alta. El escaneo sin agent debe estar activado para la cuenta de AWS que contiene el recurso que se va a escanear. This endpoint requires the `security_monitoring_findings_write` permission. OAuth apps require the `org_management` authorization [scope](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/es/api/latest/scopes.md#agentless-scanning) to access this endpoint. ### Request #### Body Data (required) La definición de la tarea bajo demanda. {% tabs %} {% tab label="Model" %} | Parent field | Field | Type | Description | | ------------ | ----------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------- | | | data [*required*] | object | Objeto de solicitud que incluye la tarea bajo demanda a enviar. | | data | attributes [*required*] | object | Attributes for the AWS on demand task. | | attributes | arn [*required*] | string | The arn of the resource to scan. Agentless supports the scan of EC2 instances, lambda functions, AMI, ECR, RDS and S3 buckets. | | data | type [*required*] | enum | The type of the on demand task. The value should always be `aws_resource`. Allowed enum values: `aws_resource`. Default: `aws_resource`. | {% /tab %} {% tab label="Example" %} ```json { "data": { "attributes": { "arn": "arn:aws:lambda:us-west-2:123456789012:function:my-function" }, "type": "aws_resource" } } ``` {% /tab %} {% /tabs %} ### Response {% tabs %} {% tab label="201" %} AWS on demand task created successfully. {% tabs %} {% tab label="Model" %} Response object that includes an AWS on demand task. | Parent field | Field | Type | Description | | ------------ | ----------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | data | object | Single AWS on demand task. | | data | attributes | object | Attributes for the AWS on demand task. | | attributes | arn | string | The arn of the resource to scan. | | attributes | assigned_at | string | Specifies the assignment timestamp if the task has been already assigned to a scanner. | | attributes | created_at | string | The task submission timestamp. | | attributes | status | string | Indicates the status of the task. QUEUED: the task has been submitted successfully and the resource has not been assigned to a scanner yet. ASSIGNED: the task has been assigned. ABORTED: the scan has been aborted after a period of time due to technical reasons, such as resource not found, insufficient permissions, or the absence of a configured scanner. | | data | id | string | The UUID of the task. | | data | type | enum | The type of the on demand task. The value should always be `aws_resource`. Allowed enum values: `aws_resource`. Default: `aws_resource`. | {% /tab %} {% tab label="Example" %} ```json { "data": { "attributes": { "arn": "arn:aws:ec2:us-east-1:727000456123:instance/i-0eabb50529b67a1ba", "assigned_at": "2025-02-11T18:25:04.550564Z", "created_at": "2025-02-11T18:13:24.576915Z", "status": "QUEUED" }, "id": "6d09294c-9ad9-42fd-a759-a0c1599b4828", "type": "aws_resource" } } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="400" %} Bad Request {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="403" %} Not Authorized {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="429" %} Too many requests {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% /tabs %} ### Code Example {% tabs %} {% tab label="Curl" %} ```bash # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com # Use a Personal Access Token or Service Access Token export DD_BEARER_TOKEN="" curl -X POST "https://api.${DD_SITE}/api/v2/agentless_scanning/ondemand/aws" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" \ -d @- << EOF { "data": { "attributes": { "arn": "arn:aws:lambda:us-west-2:123456789012:function:my-function" }, "type": "aws_resource" } } EOF ``` {% /tab %} {% tab label="Go" %} ```go // Create AWS on demand task returns "AWS on demand task created successfully." 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/datadogV2" ) func main() { body := datadogV2.AwsOnDemandCreateRequest{ Data: datadogV2.AwsOnDemandCreateData{ Attributes: datadogV2.AwsOnDemandCreateAttributes{ Arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function", }, Type: datadogV2.AWSONDEMANDTYPE_AWS_RESOURCE, }, } ctx := datadog.NewDefaultContext(context.Background()) ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN")) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewAgentlessScanningApi(apiClient) resp, r, err := api.CreateAwsOnDemandTask(ctx, body) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `AgentlessScanningApi.CreateAwsOnDemandTask`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `AgentlessScanningApi.CreateAwsOnDemandTask`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" go run "main.go" ``` {% /tab %} {% tab label="Java" %} ```java // Create AWS on demand task returns "AWS on demand task created successfully." response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.AgentlessScanningApi; import com.datadog.api.client.v2.model.AwsOnDemandCreateAttributes; import com.datadog.api.client.v2.model.AwsOnDemandCreateData; import com.datadog.api.client.v2.model.AwsOnDemandCreateRequest; import com.datadog.api.client.v2.model.AwsOnDemandResponse; import com.datadog.api.client.v2.model.AwsOnDemandType; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN")); AgentlessScanningApi apiInstance = new AgentlessScanningApi(defaultClient); AwsOnDemandCreateRequest body = new AwsOnDemandCreateRequest() .data( new AwsOnDemandCreateData() .attributes( new AwsOnDemandCreateAttributes() .arn("arn:aws:lambda:us-west-2:123456789012:function:my-function")) .type(AwsOnDemandType.AWS_RESOURCE)); try { AwsOnDemandResponse result = apiInstance.createAwsOnDemandTask(body); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling AgentlessScanningApi#createAwsOnDemandTask"); 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://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" java "Example.java" ``` {% /tab %} {% tab label="Python" %} ```python """ Create AWS on demand task returns "AWS on demand task created successfully." response """ from os import environ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.agentless_scanning_api import AgentlessScanningApi from datadog_api_client.v2.model.aws_on_demand_create_attributes import AwsOnDemandCreateAttributes from datadog_api_client.v2.model.aws_on_demand_create_data import AwsOnDemandCreateData from datadog_api_client.v2.model.aws_on_demand_create_request import AwsOnDemandCreateRequest from datadog_api_client.v2.model.aws_on_demand_type import AwsOnDemandType body = AwsOnDemandCreateRequest( data=AwsOnDemandCreateData( attributes=AwsOnDemandCreateAttributes( arn="arn:aws:lambda:us-west-2:123456789012:function:my-function", ), type=AwsOnDemandType.AWS_RESOURCE, ), ) configuration = Configuration() configuration.access_token = environ["DD_BEARER_TOKEN"] with ApiClient(configuration) as api_client: api_instance = AgentlessScanningApi(api_client) response = api_instance.create_aws_on_demand_task(body=body) print(response) ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" python3 "example.py" ``` {% /tab %} {% tab label="Ruby" %} ```ruby # Create AWS on demand task returns "AWS on demand task created successfully." response require "datadog_api_client" DatadogAPIClient.configure do |config| config.access_token = ENV["DD_BEARER_TOKEN"] end api_instance = DatadogAPIClient::V2::AgentlessScanningAPI.new body = DatadogAPIClient::V2::AwsOnDemandCreateRequest.new({ data: DatadogAPIClient::V2::AwsOnDemandCreateData.new({ attributes: DatadogAPIClient::V2::AwsOnDemandCreateAttributes.new({ arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function", }), type: DatadogAPIClient::V2::AwsOnDemandType::AWS_RESOURCE, }), }) p api_instance.create_aws_on_demand_task(body) ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" rb "example.rb" ``` {% /tab %} {% tab label="Rust" %} ```rust // Create AWS on demand task returns "AWS on demand task created successfully." // response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_agentless_scanning::AgentlessScanningAPI; use datadog_api_client::datadogV2::model::AwsOnDemandCreateAttributes; use datadog_api_client::datadogV2::model::AwsOnDemandCreateData; use datadog_api_client::datadogV2::model::AwsOnDemandCreateRequest; use datadog_api_client::datadogV2::model::AwsOnDemandType; #[tokio::main] async fn main() { let body = AwsOnDemandCreateRequest::new(AwsOnDemandCreateData::new( AwsOnDemandCreateAttributes::new( "arn:aws:lambda:us-west-2:123456789012:function:my-function".to_string(), ), AwsOnDemandType::AWS_RESOURCE, )); let configuration = datadog::Configuration::new(); let api = AgentlessScanningAPI::with_config(configuration); let resp = api.create_aws_on_demand_task(body).await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ``` {% /tab %} {% tab label="TypeScript" %} ```typescript /** * Create AWS on demand task returns "AWS on demand task created successfully." response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration({ authMethods: { AuthZ: { accessToken: process.env.DD_BEARER_TOKEN as string, }, }, }); const apiInstance = new v2.AgentlessScanningApi(configuration); const params: v2.AgentlessScanningApiCreateAwsOnDemandTaskRequest = { body: { data: { attributes: { arn: "arn:aws:lambda:us-west-2:123456789012:function:my-function", }, type: "aws_resource", }, }, }; apiInstance .createAwsOnDemandTask(params) .then((data: v2.AwsOnDemandResponse) => { 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://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" tsc "example.ts" ``` {% /tab %} {% /tabs %}