Inventory

Tenable One Cloud Exposure allows querying the asset inventory for different resources and configurations. Third-party tools can use this information to discover cloud infrastructure resources and their structure. This page lists examples for querying the inventory.

List Inventory

query {
  Entities(
    nodes {
      AccountId
      AccountName
      CustomProperties {
        Name
        Values { Value }
      }
      CreatorOriginator { Id }
      CreatorIdentity  { Id }
      CreationTime
      Id
      Labels
      Name
      Provider
      Region
      SyncTime
      Tags { Key Value }
      Type: __typename
      ... on AwsResource {
        Arn
      }
    }
  }
}

Sample response

{
  "data": {
    "Entities": {
      "nodes": [

{
          "AccountId": "42e93255-b10f-4566-87d6-eeb9a352af24",
          "AccountName": "example-production",
          "CustomProperties": [
            {
              "Name": "Name",
              "Values": [
                {
                  "Value": "qa-project"
                }
              ]
            }
          ],
          "CreatorOriginator": "ServiceAccount",
          "CreatorIdentity": "[email protected]",
          "CreationTime": "2026-03-29T00:37:27.864Z",
          "Labels": [],
          "Name": "47fc5d3a-5b97-463d-83cb-dba7fa813b77",
          "Provider": "GCP",
          "Region": "us-east-2",
          "SyncTime": "2025-11-24T14:48:21.552Z",
          "Tags": []
         }
      ]
    }
  }
}

List Kubernetes deployments and associated container images

📘

Note

Please be advised that Tenable is implementing a change to the Inventory API ContainerImages field structure. For more information, see Inventory API Container Image Field Restructuring.

query {
  Entities(
    filter: {Types: [KubernetesDeployment]}
  ) {
    nodes {
      AccountId
      Region
      Name
      SyncTime
      ... on KubernetesWorkloadResource {
        ContainerImages {
          Labels
          Provider
          Findings {
            AccountPath
          }
          Region
          SyncTime
          Tags {
            Key
            Value
          }
          AccountId
          AccountName
          Id
          ... on ContainerImage {
            Digest
            ImageTags
            OperatingSystem
            OperatingSystemType
            Repository {
              Id
            }
            RepositoryUri
            VulnerabilityScanTime
            Used
          }
        }
        Namespace {
          Name
        }
      }
    }
  }
}

Sample response

{
  "data": {
    "Entities": {
      "nodes": [
        {
          "AccountId": "123456789012",
          "Region": "us-east-2",
          "Name": "example-resource",
          "SyncTime": "2026-03-29T08:09:15.358Z",
          "ContainerImages": [
            {
              "Labels": [],
              "Provider": "AWS",
              "Findings": [],
              "Region": "us-east-2",
              "SyncTime": "2026-03-29T08:09:15.358Z",
              "Tags": [],
              "AccountId": "123456789012",
              "AccountName": "example-production",
              "Id": "a223f9d5-be33-4550-87a7-810a34215fc4",
              "Digest": "sha256:2bc303ca4f7ae1d5f45217437e30e33d70c64275b581c4f4cada9d970c64c548",
              "ImageTags": ["latest"],
              "OperatingSystem": "Ubuntu 22.04",
              "OperatingSystemType": "Linux",
              "Repository": "example-org/example-service",
              "RepositoryUri": "wordpress",
              "VulnerabilityScanTime": "2025-06-09T05:50:25.808Z",
              "Used": true
            }
          ],
          "Namespace": {
            "Name": "example-resource"
          }
        }
      ]
    }
  }
}

List AWS Kubernetes deployments with container images

📘

Note

Please be advised that Tenable is implementing a change to the Inventory API to use standardized, generic Kubernetes resource names. For more information, see Cloud Resource Querying Updates.

query {
  Entities(
    filter: {Types: [AwsKubernetesDeployment]}
  ) {
    nodes {
      AccountId
      Region
      Name
      SyncTime
      ... on AwsKubernetesDeployment {
        ContainerImages {
          Labels
          Provider
          Findings {
            AccountPath
          }
          Region
          SyncTime
          Tags {
            Key
            Value
          }
          AccountId
          AccountName
          Id
          ... on ContainerImage {
            Digest
            ImageTags
            OperatingSystem
            OperatingSystemType
            Repository {
              Id
            }
            RepositoryUri
            VulnerabilityScanTime
            Used
          }
        }
        Namespace {
          Name
        }
      }
    }
  }
}

Sample response

{
  "data": {
    "Entities": {
      "nodes": [
        {
          "AccountId": "123456789012",
          "Region": "us-east-2",
          "Name": "example-resource",
          "SyncTime": "2026-03-29T08:09:15.358Z",
          "ContainerImages": [
            {
              "Labels": [],
              "Provider": "AWS",
              "Findings": [],
              "Region": "us-east-2",
              "SyncTime": "2026-03-29T08:09:15.358Z",
              "Tags": [],
              "AccountId": "123456789012",
              "AccountName": "example-production",
              "Id": "a51aa1b0-c139-4a5b-82dc-cf34ff6e611d",
              "Digest": "sha256:1cf3b44dcc24c7774b8c272b409b0883f55fb448b116630b3a608a99ee926406",
              "ImageTags": ["latest"],
              "OperatingSystem": "Ubuntu 22.04",
              "OperatingSystemType": "Linux",
              "Repository": "example-org/example-service",
              "RepositoryUri": "wordpress",
              "VulnerabilityScanTime": "2025-06-09T05:50:25.808Z",
              "Used": true
            }
          ],
          "Namespace": {
            "Name": "cert-manager"
          }
        }
      ]
    }
  }
}

List entities from specific cloud providers

📘

Note

Please be advised that Tenable is implementing a change to the Inventory API to use standardized, generic Kubernetes resource names. For more information, see Cloud Resource Querying Updates.

query {
  Entities(
    filter: {
      Providers: [
        AWS,
        Azure
      ]
    })
  {
    nodes {
      Name
      Provider
      AccountId
      __typename
      ... on AwsResource {
        Region
      }
      ... on AzureResource {
        Region
      }
    }
  }
}

Sample response

{
  "data": {
    "Entities": {
      "nodes": [
        {
          "Name": "example-resource",
          "Providers": "AWS",
          "AccountId": "123456789012",
          "__typename": "AwsEc2Instance",
          "Region": "us-east-2"
        },
        {
          "Name": "example-resource",
          "Provider": "Azure",
          "AccountId": "b2b791b4-9464-4c1f-be36-9fba53767b78",
          "__typename": "AzureComputeVirtualMachine",
          "Region": "eastus2"
        }
      ]
    }
  }
}

List AWS resources, filtered by type, region, and creation time

📘

Note

Please be advised that Tenable is implementing a change to the Inventory API to use standardized, generic Kubernetes resource names. For more information, see Cloud Resource Querying Updates.

query {
  AwsResources(
    filter: {
      Types: [AwsEcrRepository]
      Regions: 
      CreationTime: {
        startTime:
        endTime:
    nodes {
      Name
      Region
      CreationTime
      __typename
    }
  }
}

Sample response

{
  "data": {
    "AwsResources": {
      "nodes": [
        {
          "Name": "example-resource",
          "Region": "us-east-2",
          "CreationTime": "2026-03-29T00:37:27.864Z",
          "__typename": "AwsEcrRepository"
        }
      ]
    }
  }
}

List all Azure resources from a specific resource group

📘

Note

Please be advised that Tenable is implementing a change to the Inventory API to use standardized, generic Kubernetes resource names. For more information, see Cloud Resource Querying Updates.

query {
  AzureResources(
    filter: {
      ResourceGroupIds: 
    })
  {
    nodes {
      Name
      Region
      CreationTime
      __typename
      ... on AzureResourceGroupResource {
        ResourceGroupId
      }
    }
  }
}

Sample response

{
  "data": {
    "AzureResources": {
      "nodes": [
        {
          "Name": "example-resource",
          "Region": "us-east-2",
          "CreationTime": "2026-03-29T00:37:27.864Z",
          "__typename": "AzureNetworkRouteTable",
          "ResourceGroupId": "/subscriptions/8f4a2b19-6c3d-4e5f-9a7b-1c2d3e4f5a6b/resourceGroups/example-rg"
        },
        {
          "Name": "example-resource",
          "Region": "us-east-2",
          "CreationTime": "2026-03-29T00:37:27.864Z",
          "__typename": "AzureNetworkNetworkSecurityGroup",
          "ResourceGroupId": "/subscriptions/8f4a2b19-6c3d-4e5f-9a7b-1c2d3e4f5a6b/resourceGroups/example-rg"
        },
        {
          "Name": "example-resource",
          "Region": "us-east-2",
          "CreationTime": "2026-03-29T00:37:27.864Z",
          "__typename": "AzureSqlServer",
          "ResourceGroupId": "/subscriptions/8f4a2b19-6c3d-4e5f-9a7b-1c2d3e4f5a6b/resourceGroups/example-rg"
        }
      ]
    }
  }
}

List Kubernetes resources, filtered by Providers

📘

Note

Please be advised that Tenable is implementing a change to the Inventory API to use standardized, generic Kubernetes resource names. For more information, see Cloud Resource Querying Updates.

query {
  Entities(filter: {Types: [KubernetesClusterRole], Providers: [AWS, Azure]}){ 
    nodes {
  		...on KubernetesResource {
        KubernetesLabels {
          Key
          Value        
        KubernetesAnnotations {
          Key
          Value
        }
      }
    }
  }
}

Sample response

{
    "data": {
        "Entities": {
            "nodes": [
                {
                    "KubernetesLabels": [
                        {
                            "Key": "Environment",
                            "Value": "qa-project"
                        }
                    ],
                    "KubernetesAnnotations": [
                        {
                            "Key": "Environment",
                            "Value": "qa-project"
                        }
                    ]
                }
            ]
        }
    }
}

List Azure AD users, and their role assignments

query {
  AzureAdUsers(first:10){
    nodes {
      Name
      Mail
      AzureRoleAssignments {
        Id
        Name
        Status
        PrincipalReference {
          Principal{
            Name
          }
          Type
        }
        RoleDefinition {
          Name
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Sample response

{
  "data": {
    "AzureAdUsers": {
      "nodes": [
        {
          "Name": "example-resource",
          "Mail": null,
          "AzureRoleAssignments": [
            {
              "Id": "c3942593-8e33-4151-8059-bd4fd38909b8",
              "Name": "example-resource",
              "Status": "Open",
              "PrincipalReference": {
                "Principal": {
                  "Name": "example-resource"
                },
                "Type": "Group"
              },
              "RoleDefinition": {
                "Name": "Owner"
              }
            }
          ]
        }
      ],
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": "VGVzdEJhc2U2NEN1cnNvcg=="
      }
    }
  }
}

List Azure role assignments

The example below shows a query that lists all role assignments with a role definition of owner, that have a scope level/type of either management group or resource group, and a status of active.

query  {
  AzureAuthorizationRoleAssignmentResources(
    first: 100
    filter: {
      RoleDefinitionNames: ["Owner"]
      Statuses: [Active]
      RoleAssignmentScopeTypes: [ManagementGroup, ResourceGroup]
    })
  {
    nodes {
      Pim
      Status
      ScopeReference {
        Id
        Type
      }
      PrincipalReference {
        Id
        Type
        Principal {
          Id
          Name
          __typename
        }
      }
      RoleDefinition {
        Name
        Definition
      }
      __typename
    }
  }
}

Sample response

{
  "data": {
    "AzureAuthorizationRoleAssignmentResources": {
      "nodes": [
        {
          "Pim": false,
          "Status": "Active",
          "ScopeReference": {
            "Id": "d32a98b3-279f-4ecf-8288-50281e697dec",
            "Type": "ResourceGroup"
          },
          "PrincipalReference": {
            "Id": "855d7737-08f9-4380-8b15-bea352f26bdc",
            "Type": "ServicePrincipal",
            "Principal": null
          },
          "RoleDefinition": {
            "Name": "Owner",
            "Definition": {
              "properties": {
                "assignableScopes": [
                  "/"
                ],
                "description": "Grants full access to manage all resources, including the ability to assign roles in Azure RBAC.",
                "id": "c44889cb-62ec-40b1-96b6-460b463ca597",
                "name": "example-group",
                "permissions": [
                  {
                    "actions": [
                      "*"
                    ],
                    "notActions": [],
                    "dataActions": [],
                    "notDataActions": []
                  }
                ],
                "roleName": "Owner",
                "roleType": "BuiltInRole"
              }
            }
          },
          "__typename": "AzureAuthorizationRoleAssignment"
        }
      ]
    }
  }
}

List GCP role bindings

The example below shows a query that lists all role bindings with a role name of Owner or Security Reviewer, and that have a scope type of either organization or project.

query {
  GcpIamRoleBindings(
    filter: {
      RoleNames: ["Owner", "Security Reviewer"]
      RoleBindingScopeTypes: [Organization, Project]
    })
  {
    nodes {
      Role {
        Name
      }
      ScopeReference {
        Id
        Type
      }
      PrincipalReference {
        Id
        Type
      }
    }
  }
}

Sample response

{
  "data": {
    "GcpIamRoleBindings": {
      "nodes": [
        {
          "Role": {
            "Name": "Security Reviewer"
          },
          "ScopeReference": {
            "Id": "71bedf0f-3cdd-4986-8502-0a3360324348",
            "Type": "Project"
          },
          "PrincipalReference": {
            "Id": "fb8f03b2-bf20-422c-84a1-830e9f45d2f0",
            "Type": "ServiceAccount"
          }
        },
        {
          "Role": {
            "Name": "Security Reviewer"
          },
          "ScopeReference": {
            "Id": "92789fdb-a0b7-45d8-8274-0fa730cc9dbc",
            "Type": "Organization"
          },
          "PrincipalReference": {
            "Id": "da7ce68e-05f0-4e27-87cd-7e7703b08eae",
            "Type": "ServiceAccount"
          }
        }
      ]
    }
  }
}

List AWS ECR repositories, and their images and vulnerabilities

query {
  AwsResources (
    filter: {
      Types: [AwsEcrRepository]
    })
  {
    nodes {
      Arn
      AccountId
      Region
      ... on AwsEcrRepository {
        ContainerImages {
          CreationTime
          Tags
          Vulnerabilities {
            Id
            Severity
            Links
          }
        }
      }
    }
  }
}

Sample response

{
  "data": {
    "AwsResources": {
      "nodes": [
        {
          "Arn": "arn:aws:iam::123456789012:role/ExampleRole",
          "AccountId": "123456789012",
          "Region": "us-east-2",
          "ContainerImages": [
            {
              "CreationTime": "2026-03-29T00:37:27.864Z",
              "Tags": [
                "latest"
              ],
              "Vulnerabilities": []
            },
            {
              "CreationTime": "2026-03-29T00:37:27.864Z",
              "Tags": [
                "latest"
              ],
              "Vulnerabilities": [
                {
                  "Id": "CVE-2020-12663",
                  "Severity": "High",
                  "Links": []
                },
                {
                  "Id": "CVE-2021-38199",
                  "Severity": "Medium",
                  "Links": []
                },
                {
                  "Id": "CVE-2019-14814",
                  "Severity": "High",
                  "Links": []
                }
              ]
            }
          ]
        },
        {
          "Arn": "arn:aws:iam::111122223333:role/ExampleRole",
          "AccountId": "111122223333",
          "Region": "us-east-2",
          "ContainerImages": []
        }
      ]
    }
  }
}

List GCP service account key Admin role bindings assigned directly to resources

query GetAllGCPRoleBindings{
  GcpIamRoleBindings (
    filter: {
      RoleNames: ["Service Account Key Admin"],
      RoleBindingScopeTypes: [Resource]
    })
  {
    nodes {
      Id,
      AccountId,
      Name,
      PrincipalReference {
        Principal {
          ... on GoogleWorkspacePrincipal {
            Id,
            Name,
            Mail
          }
          __typename
        }
      },
      Role {
        Name
      },
      ScopeReference {
        Id,
        Type
      }
    }
    pageInfo {
      hasNextPage,
      endCursor
    }
  }
}

Sample response

{
  "data": {
    "GcpIamRoleBindings": {
      "nodes": [
        {
          "Id": "f831bc3b-a9cd-4c78-8f3a-c1f40e62805c",
          "AccountId": "C0bwmv63q",
          "Name": "example-resource",
          "PrincipalReference": {
            "Principal": {
              "Id": "9c545ff8-97bd-4641-86f5-96d3ad67ce44",
              "Name": "example-resource",
              "Mail": "[email protected]",
              "__typename": "GoogleWorkspaceUser"
            }
          },
          "Role": {
            "Name": "Editor"
          },
          "ScopeReference": {
            "Id": "9eb09aec-0aef-4cdc-80c9-e679fd5be07b",
            "Type": "Resource"
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "VGVzdEJhc2U2NEN1cnNvcg=="
      }
    }
  }
}

List AWS SSO and IAM users, and their groups and policies

query {
  AwsResources(
    filter: {Types: [AwsSsoUser, AwsIamUser]}
    first: 5)
  {
    nodes {
      Id,
      Name,
      AccountId,
      CreationTime
      ... on AwsSsoUser {
        Active,
        AssumableRoles {
          Role {
            Id,
            Name,
            CreationTime,
            Policies {
              Id,
              Name,
              CreationTime
              Arn
            },
            ActivityTime,
            Arn
          }
        },
        Groups {
            # Roles assumable via AWS SSO Groups already available
            # under 'AssumableRoles'.
            Id,
            Name
        },
        Tags {
          Key
          Value
        }
      }
      ... on AwsIamUser {
        MfaEnabled,
        Name,
        Password {
          CreationTime,
          Enabled,
          UsageTime
        },
        AccessKeys {
          CreationTime,
          Enabled,
          UsageTime
        },
        Groups {
            Id,
            Name,
            Policies {
              Arn,
              Name
            }
        },
        Policies {
          Arn,
          Name
        }
      }
    }
  }
}

Sample response

{
  "data": {
    "AwsResources": {
      "nodes": [
        {
          "Id": "6ad15dbe-4e30-4e71-8af1-5ee372772d12",
          "Name": "example-resource",
          "AccountId": "123456789012",
          "CreationTime": "2026-03-29T00:37:27.864Z",
          "MfaEnabled": false,
          "Password": {
            "CreationTime": "2026-03-29T00:37:27.864Z",
            "Enabled": true,
            "UsageTime": "2026-03-29T08:05:35.917Z"
          },
          "AccessKeys": [
            {
              "CreationTime": "2026-03-29T00:37:27.864Z",
              "Enabled": true,
              "UsageTime": "2026-03-29T08:05:35.917Z"
            },
            {
              "CreationTime": "2026-03-29T00:37:27.864Z",
              "Enabled": true,
              "UsageTime": "2026-03-29T08:05:35.917Z"
            }
          ],
          "Groups": [],
          "Policies": [
            {
              "Arn": "arn:aws:iam::111122223333:role/ExampleRole",
              "Name": "AdministratorAccess"
            }
          ]
        }
      ]
    }
  }
}

List raw JSON for cloud resources

Use the json field to return the full resource payload retrieved directly from the cloud provider, giving you access to properties not otherwise surfaced in the API.

📘

Note

The content and structure of the Json field is defined by the cloud provider. Tenable does not control it and cannot guarantee it remains static. Supported providers may change field names, values, or structure at any time. Build any downstream logic that parses this field with that in mind.

query {
  AwsResources(first: 10) {
    nodes {
      Name
      Json
      Region
      CreationTime
      __typename
    }
  }
}

Sample response

{
  "data": {
    "AwsResources": {
      "nodes": [
        {
          "Name": "windows-test",
          "Json": "1583cd99-5ea5-48fe-8b0d-d8f6aad1fc2b",
          "Region": "us-east-2",
          "CreationTime": null,
          "__typename": "AwsSsmManagedInstance"
        }
      ]
    }
  }
}

Did this page help you?