Fetch Container Details

Parameter	Mandatory/Optional	Data Type	Description
containerSha	Mandatory	string	Specify the SHA value of a specific container in the user’s scope.

API request

    curl -X "GET"
"<qualys_base_url>/csapi/v1.3/containers/647ae732d98e1bcceb7b02356bd7e873eef13c5916c3a1e9d95700ab893cc09f"
-H "accept: application/json"
-H "Authorization: Bearer <token>"  
    

Response

   {
  "portMapping": null,
  "imageId": "3acfa0195040",
  "created": "1724220796000",
  "updated": "1724329261476",
  "label": null,
  "uuid": "a223de44-1871-3470-b575-fc0ff52453f7",
  "sha": "42dd6168e45c6d7f7ab3043d7942d50ac8db0230066350d3c6dd9e53b30c5e91",
  "privileged": false,
  "path": null,
  "imageSha": "3acfa01950409618705f07e1cc86f29f10ebcf548fe4fb4a7b83abe5bbc6b515",
  "macAddress": null,
  "customerUuid": "7a00a660-36bb-f02b-8025-9fcf49faf0b7",
  "ipv4": null,
  "ipv6": null,
  "name": "spring-1",
  "host": null,
  "hostArchitecture": [
    "x86_64"
  ],
  "state": "RUNNING",
  "imageUuid": "0ba3ff46-5336-3494-84a4-ee981675963c",
  "containerId": "42dd6168e45c",
  "stateChanged": "1724243635787",
  "services": null,
  "users": null,
  "operatingSystem": null,
  "lastScanned": null,
  "source": "CLUSTER",
  "riskScore": null,
  "riskScoreCalculatedDate": null,
  "formulaUsed": null,
  "maxQdsScore": null,
  "qdsSeverity": null,
  "scanTypes": null,
  "criticality": null,
  "criticalityUpdated": null,
  "vulnPropagationDate": "1743148605300",  
  "isVulnPropagated": true,
  "sensorUuid": "197ddd8b-d4d2-4821-bf73-005347bc933a",
  "environment": null,
  "arguments": null,
  "command": "null",
  "drift": null,
  "vulnerabilities": [
{  "severity5Count": 6,  
"severity3Count": 2,  
"severity4Count": 4,  
"severity1Count": null,  
"severity2Count": 3  },
],
  "softwares": null,
  "isDrift": false,
  "isRoot": null,
  "lastComplianceScanned": null,
  "cluster": {
    "type": "KUBERNETES",
    "k8s": {
      "project": null,
      "pod": {
        "name": "spring-1",
        "uuid": "4a7d3fc3-de97-44eb-85d3-5f661a175337",
        "namespace": "default",
        "namespaceMetadata": {
          "labels": [
            "kubernetes.io/metadata.name:default"
          ],
          "annotations": [
            "kubernetes.io/metadata.name:test",
            "kubernetes.io/metadata.name:default"
          ]
        },
        "label": null,
        "controller": null
      },
      "node": {
        "name": null,
        "isMaster": null
      }
    },
    "name": "kubernetes-admin",
    "uid": "bdc0d232-38af-46f9-b188-06cb61c928af",
    "version": null
  },
  "cloudProvider": {
    "aws.ecs.container.subnetId": null,
    "aws.eks.accountId": "362440600222",
    "aws.ecs.clusterName": null,
    "aws.ecs.container.macAddress": null,
    "aws.ecs.region.code": null,
    "aws.ecs.container.id": null,
    "aws.ecs.accountId": null,
    "aws.eks.arn": "arn:aws:sts::362440600222:assumed-role/AmazonSSMRoleForInstancesQuickSetup/i-0921342848h431ef8",
    "aws.eks.region": "us-east-1"
  },
  "exceptions": null,
  "k8sExposure": null
}

Error Response

The following error response is seen when the sub-users don't have permission to the specified containerSha.

    {  
    "errorCode": "403 FORBIDDEN",  
    "message": "Request Forbidden",  
    "timestamp": 1700721586546
    } 

This sample includes container details for AWS Fargate. Therefore, you’ll see the source value as “SERVERLESS_FARGATE” and the AWS ECS cloudProvider fields in the response.

API request

    curl -X "GET"
"<qualys_base_url>/csapi/v1.3/containers/e39c5d55eb8638699f1099c5bd1527df1268aeef3628124e5a9ed6133fb03bba"
-H "accept: application/json" 
-H "Authorization: Bearer <token>"
    

Response

    {
    "portMapping": null,
    "imageId": "544d56423393",
    "created": "1685526156673",
    "updated": "1685526276307",
    "label": null,
    "uuid": "8946efb6-9f63-3b24-a4eb-1bb1285db496",
    "sha": "e39c5d55eb8638699f1099c5bd1527df1268aeef3628124e5a9ed6133fb03bba",
    "privileged": false,
    "path": null,
    "imageSha": "544d56423393b9eceacb196ea0a043f5940689269a6a6fcc9387a8b9b14f3fcc",
    "macAddress": null,
    "customerUuid": "6a849349-679f-ef25-8296-e51d4e3a0019",
    "ipv4": null,
    "ipv6": null,
    "name": "wordpress_php80",
    "host": null,
    "hostArchitecture": null,
    "state": "STOPPED",
    "imageUuid": "eb82a38d-5ed1-3852-a092-58b24380d011",
    "containerId": "e39c5d55eb86",
    "stateChanged": "1685526157920",
    "services": null,
    "users": null,
    "operatingSystem": null,
    "lastScanned": null,
    "source": "SERVERLESS_FARGATE",
    "riskScore": null,
    "riskScoreCalculatedDate": null,
    "formulaUsed": null,
    "maxQdsScore": null,
    "qdsSeverity": null,
    "scanTypes": null,
    "criticality": null,
    "criticalityUpdated": null,
    "vulnPropagationDate": "1743148605300",  
    "isVulnPropagated": true,
    "sensorUuid": "197ddd8b-d4d2-4821-bf73-005347bc933a",
    "environment": null,
    "arguments": null,
    "command": null,
    "drift": null,
    "vulnerabilities": [],
    "softwares": null,
    "isDrift": false,
    "isRoot": null,
    "lastComplianceScanned": null,
    "cluster":{
    "type": "KUBERNETES",
    "k8s": {
      "project": null,
      "pod": {
        "name": "spring-1",
        "uuid": "4a7d3fc3-de97-44eb-85d3-5f661a175337",
        "namespace": "default",
        "namespaceMetadata": {
          "labels": [
            "kubernetes.io/metadata.name:default"
          ],
          "annotations": [
            "kubernetes.io/metadata.name:test",
            "kubernetes.io/metadata.name:default"
          ]
        },
    "cloudProvider": {
        "aws.ecs.container.subnetId": "subnet-073576bdd0261adda",
        "aws.ecs.clusterName": "jack-explore",
        "aws.ecs.container.macAddress": "06:**:4*:*0:**:45",
        "aws.ecs.region.code": "us-west-2",
        "aws.ecs.container.id": "1292cfce-301f-4817-a86f-8da65d431e3b",
        "aws.ecs.accountId": "36******0442"
    }
    "exceptions": [
    {
     "uuid": "624efd86-6172-4851-beb1-75cb9b1634fb",
     "assignmentType": "CASCADE"
    },
    {
    "riskScore": 258,
    "riskScoreCalculatedDate": "1722355883371",
    "formulaUsed": "MIN (1000 , 2 * ( 1.0 * 64.70 * Pow(10,0.01) + 0.6 *60.04 * Pow(26,0.01) + 0.4 * 44.35 * Pow(147,0.01) + 0.2 *36.20*Pow(5,0.01) ))",
    "maxQdsScore": 87,
    "qdsSeverity": "CRITICAL"
    "criticality": 3,
    "criticalityUpdated": 1717098843553,
    }
    ]
}

Error Response 

The following error response will be seen when the sub-users don't have permission to the specified containerSha.

    {  
    "errorCode": "403 FORBIDDEN",  
    "message": "Request Forbidden",  
    "timestamp": 1700721586546
    }