The DataScanners API from Microsoft Defender — 2 operation(s) for datascanners.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/microsoft-defender:microsoft-defender-datascanners-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Microsoft Defender for Cloud REST API (Microsoft.Security)…
version: stable-composite
description: Composite of the latest stable Microsoft.Security resource-manager swagger files published by Microsoft in Azure/azure-rest-api-specs. Each path keeps its own api-version via x-source.
x-source-repo: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/security/resource-manager/Microsoft.Security/Security
servers:
- url: https://management.azure.com
security:
- azure_auth:
- user_impersonation
tags:
- name: DataScanners
paths:
/{scopeId}/providers/Microsoft.Security/dataScanners:
get:
operationId: DataScanners_List
tags:
- DataScanners
description: Lists all data scanner resources for the specified scope.
parameters:
- $ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
- name: scopeId
in: path
description: 'The scope of the data scanner. Valid scopes are a subscription (format: ''subscriptions/{subscriptionId}'') or a resource group (format: ''subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'').'
required: true
x-ms-skip-url-encoding: true
schema:
type: string
responses:
'200':
description: Azure operation completed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/DataScannerList'
default:
description: An unexpected error response.
content:
application/json:
schema:
$ref: '#/components/schemas/Common.CloudError'
x-ms-examples:
Lists all data scanner resources at subscription scope.:
$ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/examples/DataScanners/ListDataScanners.json
x-ms-pageable:
nextLinkName: nextLink
x-source: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/datascanners.json
summary: Data scanners list
x-summary-source: derived
/{scopeId}/providers/Microsoft.Security/dataScanners/{scannerName}:
get:
operationId: DataScanners_Get
tags:
- DataScanners
description: Gets a data scanner resource for the specified scope.
parameters:
- $ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
- name: scopeId
in: path
description: 'The scope of the data scanner. Valid scopes are a subscription (format: ''subscriptions/{subscriptionId}'') or a resource group (format: ''subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'').'
required: true
x-ms-skip-url-encoding: true
schema:
type: string
- name: scannerName
in: path
description: The name of the data scanner.
required: true
schema:
type: string
pattern: ^[a-zA-Z0-9-]{1,260}$
responses:
'200':
description: Azure operation completed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/DataScanner'
default:
description: An unexpected error response.
content:
application/json:
schema:
$ref: '#/components/schemas/Common.CloudError'
x-ms-examples:
Gets a data scanner resource at resource group scope.:
$ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/examples/DataScanners/GetDataScannerResourceGroupScope.json
Gets a data scanner resource at subscription scope.:
$ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/examples/DataScanners/GetDataScanner.json
x-source: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/datascanners.json
summary: Data scanners get
x-summary-source: derived
put:
operationId: DataScanners_CreateOrUpdate
tags:
- DataScanners
description: Creates or updates a data scanner resource for the specified scope.
parameters:
- $ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
- name: scopeId
in: path
description: 'The scope of the data scanner. Valid scopes are a subscription (format: ''subscriptions/{subscriptionId}'') or a resource group (format: ''subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'').'
required: true
x-ms-skip-url-encoding: true
schema:
type: string
- name: scannerName
in: path
description: The name of the data scanner.
required: true
schema:
type: string
pattern: ^[a-zA-Z0-9-]{1,260}$
responses:
'200':
description: Resource 'DataScanner' update operation succeeded
content:
application/json:
schema:
$ref: '#/components/schemas/DataScanner'
'201':
description: Resource 'DataScanner' create operation succeeded
content:
application/json:
schema:
$ref: '#/components/schemas/DataScanner'
default:
description: An unexpected error response.
content:
application/json:
schema:
$ref: '#/components/schemas/Common.CloudError'
x-ms-examples:
Creates or updates a data scanner resource at resource group scope.:
$ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/examples/DataScanners/CreateOrUpdateDataScannerResourceGroupScope.json
Creates or updates a data scanner resource at subscription scope.:
$ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/examples/DataScanners/CreateOrUpdateDataScanner.json
x-source: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/datascanners.json
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DataScanner'
description: The data scanner resource.
required: true
summary: Data scanners create or update
x-summary-source: derived
delete:
operationId: DataScanners_Delete
tags:
- DataScanners
description: Deletes a data scanner resource for the specified scope.
parameters:
- $ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
- name: scopeId
in: path
description: 'The scope of the data scanner. Valid scopes are a subscription (format: ''subscriptions/{subscriptionId}'') or a resource group (format: ''subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'').'
required: true
x-ms-skip-url-encoding: true
schema:
type: string
- name: scannerName
in: path
description: The name of the data scanner.
required: true
schema:
type: string
pattern: ^[a-zA-Z0-9-]{1,260}$
responses:
'200':
description: Resource deleted successfully.
'204':
description: Resource does not exist.
default:
description: An unexpected error response.
content:
application/json:
schema:
$ref: '#/components/schemas/Common.CloudError'
x-ms-examples:
Deletes a data scanner resource at resource group scope.:
$ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/examples/DataScanners/DeleteDataScannerResourceGroupScope.json
Deletes a data scanner resource at subscription scope.:
$ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/examples/DataScanners/DeleteDataScanner.json
x-source: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/security/resource-manager/Microsoft.Security/Security/stable/2026-08-01/datascanners.json
summary: Data scanners delete
x-summary-source: derived
components:
schemas:
DataScanner:
type: object
description: The data scanner resource used by Defender for Storage to scan data for malware and sensitive data discovery.
properties:
properties:
$ref: '#/components/schemas/DataScannerProperties'
description: Data scanner resource properties.
identity:
$ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/common-types/resource-management/v5/managedidentity.json#/definitions/SystemAssignedServiceIdentity
description: The managed service identities assigned to this resource.
allOf:
- $ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/common-types/resource-management/v5/types.json#/definitions/ProxyResource
Common.CloudErrorBody:
type: object
description: The error detail.
properties:
code:
type: string
description: The error code.
readOnly: true
message:
type: string
description: The error message.
readOnly: true
target:
type: string
description: The error target.
readOnly: true
details:
type: array
description: The error details.
items:
$ref: '#/components/schemas/Common.CloudErrorBody'
readOnly: true
x-ms-identifiers: []
additionalInfo:
type: array
description: The error additional info.
items:
$ref: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/common-types/resource-management/v5/types.json#/definitions/ErrorAdditionalInfo
readOnly: true
x-ms-identifiers: []
x-ms-external: true
DataScannerProperties:
type: object
description: Data scanner resource properties. The data scanner is an identity-only resource defined solely by its assigned managed identity.
Common.CloudError:
type: object
description: Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).
properties:
error:
$ref: '#/components/schemas/Common.CloudErrorBody'
description: The error object.
x-ms-client-flatten: true
x-ms-external: true
DataScannerList:
type: object
description: List of data scanner resources.
properties:
value:
type: array
description: The list of data scanner resources.
items:
$ref: '#/components/schemas/DataScanner'
nextLink:
type: string
format: uri
description: The URI to fetch the next page.
required:
- value
securitySchemes:
azure_auth:
type: oauth2
flows:
implicit:
scopes:
user_impersonation: impersonate your user account
authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
description: Azure Active Directory OAuth2 Flow.