--- title: Récupérer l'analyse de couverture CSM pour les hosts et conteneurs description: Récupérer l'analyse de couverture CSM de vos hosts et conteneurs. breadcrumbs: Documentation > API > Récupérer l'analyse de couverture CSM pour les hosts et conteneurs --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/llms.txt). # Récupérer l'analyse de couverture CSM pour les hosts et conteneurs ## v2 (latest) | Datadog site | API endpoint | | ----------------- | ---------------------------------------------------------------------------------------------- | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/csm/onboarding/coverage_analysis/hosts_and_containers | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/csm/onboarding/coverage_analysis/hosts_and_containers | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/csm/onboarding/coverage_analysis/hosts_and_containers | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/csm/onboarding/coverage_analysis/hosts_and_containers | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/csm/onboarding/coverage_analysis/hosts_and_containers | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/csm/onboarding/coverage_analysis/hosts_and_containers | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/csm/onboarding/coverage_analysis/hosts_and_containers | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/csm/onboarding/coverage_analysis/hosts_and_containers | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/csm/onboarding/coverage_analysis/hosts_and_containers | ### Overview Récupérer l'analyse de couverture CSM de vos hosts et conteneurs. Ce calcul est basé sur le nombre d'agents s'exécutant sur vos hosts et conteneurs avec une ou plusieurs fonctionnalités CSM activées. ### Response {% tabs %} {% tab label="200" %} OK {% tabs %} {% tab label="Model" %} CSM Hosts and Containers Coverage Analysis response. | Parent field | Field | Type | Description | | -------------- | ------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | data | object | CSM Hosts and Containers Coverage Analysis data. | | data | attributes | object | CSM Hosts and Containers Coverage Analysis attributes. | | attributes | cspm_coverage | object | CSM Coverage Analysis. | | cspm_coverage | configured_resources_count | int64 | The number of fully configured resources. | | cspm_coverage | coverage | double | The coverage percentage. | | cspm_coverage | partially_configured_resources_count | int64 | The number of partially configured resources. | | cspm_coverage | total_resources_count | int64 | The total number of resources. | | attributes | cws_coverage | object | CSM Coverage Analysis. | | cws_coverage | configured_resources_count | int64 | The number of fully configured resources. | | cws_coverage | coverage | double | The coverage percentage. | | cws_coverage | partially_configured_resources_count | int64 | The number of partially configured resources. | | cws_coverage | total_resources_count | int64 | The total number of resources. | | attributes | org_id | int64 | The ID of your organization. | | attributes | total_coverage | object | CSM Coverage Analysis. | | total_coverage | configured_resources_count | int64 | The number of fully configured resources. | | total_coverage | coverage | double | The coverage percentage. | | total_coverage | partially_configured_resources_count | int64 | The number of partially configured resources. | | total_coverage | total_resources_count | int64 | The total number of resources. | | attributes | vm_coverage | object | CSM Coverage Analysis. | | vm_coverage | configured_resources_count | int64 | The number of fully configured resources. | | vm_coverage | coverage | double | The coverage percentage. | | vm_coverage | partially_configured_resources_count | int64 | The number of partially configured resources. | | vm_coverage | total_resources_count | int64 | The total number of resources. | | data | id | string | The ID of your organization. | | data | type | string | The type of the resource. The value should always be `get_hosts_and_containers_coverage_analysis_response_public_v0`. Default: `get_hosts_and_containers_coverage_analysis_response_public_v0`. | {% /tab %} {% tab label="Example" %} ```json { "data": { "attributes": { "cspm_coverage": { "configured_resources_count": 8, "coverage": 0.8, "partially_configured_resources_count": 0, "total_resources_count": 10 }, "cws_coverage": { "configured_resources_count": 8, "coverage": 0.8, "partially_configured_resources_count": 0, "total_resources_count": 10 }, "org_id": 123456, "total_coverage": { "configured_resources_count": 8, "coverage": 0.8, "partially_configured_resources_count": 0, "total_resources_count": 10 }, "vm_coverage": { "configured_resources_count": 8, "coverage": 0.8, "partially_configured_resources_count": 0, "total_resources_count": 10 } }, "id": "66b3c6b5-5c9a-457e-b1c3-f247ca23afa3", "type": "get_hosts_and_containers_coverage_analysis_response_public_v0" } } ``` {% /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 GET "https://api.${DD_SITE}/api/v2/csm/onboarding/coverage_analysis/hosts_and_containers" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" ``` {% /tab %} {% tab label="Go" %} ```go // Get the CSM Hosts and Containers Coverage Analysis 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/datadogV2" ) func main() { 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.NewCSMCoverageAnalysisApi(apiClient) resp, r, err := api.GetCSMHostsAndContainersCoverageAnalysis(ctx) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `CSMCoverageAnalysisApi.GetCSMHostsAndContainersCoverageAnalysis`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `CSMCoverageAnalysisApi.GetCSMHostsAndContainersCoverageAnalysis`:\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 // Get the CSM Hosts and Containers Coverage Analysis returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.CsmCoverageAnalysisApi; import com.datadog.api.client.v2.model.CsmHostsAndContainersCoverageAnalysisResponse; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN")); CsmCoverageAnalysisApi apiInstance = new CsmCoverageAnalysisApi(defaultClient); try { CsmHostsAndContainersCoverageAnalysisResponse result = apiInstance.getCSMHostsAndContainersCoverageAnalysis(); System.out.println(result); } catch (ApiException e) { System.err.println( "Exception when calling CsmCoverageAnalysisApi#getCSMHostsAndContainersCoverageAnalysis"); 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 """ Get the CSM Hosts and Containers Coverage Analysis returns "OK" response """ from os import environ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.csm_coverage_analysis_api import CSMCoverageAnalysisApi configuration = Configuration() configuration.access_token = environ["DD_BEARER_TOKEN"] with ApiClient(configuration) as api_client: api_instance = CSMCoverageAnalysisApi(api_client) response = api_instance.get_csm_hosts_and_containers_coverage_analysis() 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 # Get the CSM Hosts and Containers Coverage Analysis returns "OK" response require "datadog_api_client" DatadogAPIClient.configure do |config| config.access_token = ENV["DD_BEARER_TOKEN"] end api_instance = DatadogAPIClient::V2::CSMCoverageAnalysisAPI.new p api_instance.get_csm_hosts_and_containers_coverage_analysis() ``` #### 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 // Get the CSM Hosts and Containers Coverage Analysis returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_csm_coverage_analysis::CSMCoverageAnalysisAPI; #[tokio::main] async fn main() { let configuration = datadog::Configuration::new(); let api = CSMCoverageAnalysisAPI::with_config(configuration); let resp = api.get_csm_hosts_and_containers_coverage_analysis().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 /** * Get the CSM Hosts and Containers Coverage Analysis returns "OK" 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.CSMCoverageAnalysisApi(configuration); apiInstance .getCSMHostsAndContainersCoverageAnalysis() .then((data: v2.CsmHostsAndContainersCoverageAnalysisResponse) => { 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 %}