Microsoft Azure Defender Easm is a comprehensive security solution that helps organizations protect their cloud resources and workloads from various cyber threats. Easm stands for Endpoint and Server Management, and this tool focuses on monitoring and securing endpoints and servers within an organization's Azure environment.
swagger: '2.0'
info:
title: Microsoft Azure Defender EASM
version: 2023-03-01-preview
description: >-
Defender EASM discovers and maps your digital attack surface to provide an
"outside-in" perspective using probes to discover assets. The assets are
provided with detailed metadata associated, including vulnerabilities,
configurations and web components, allowing customers to view and prioritize
external risk. The EASM REST API enables you to develop clients that
integrate with your application.
x-typespec-generated:
- emitter: '@azure-tools/typespec-autorest'
schemes:
- https
x-ms-parameterized-host:
hostTemplate: '{endpoint}'
useSchemePrefix: false
parameters:
- name: endpoint
in: path
description: >-
The endpoint hosting the requested resource. For example,
https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
required: true
type: string
produces:
- application/json
consumes:
- application/json
security:
- OAuth2Auth:
- https://easm.defender.microsoft.com/.default
securityDefinitions:
OAuth2Auth:
type: oauth2
flow: implicit
authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
scopes:
https://easm.defender.microsoft.com/.default: ''
tags:
- name: Assets
- name: Data Connections
- name: Discovery Groups
- name: Discovery Templates
- name: Reports
- name: Saved Filters
- name: Tasks
paths:
/assets:
get:
operationId: microsoftAzureAssetsListassetresource
tags:
- Assets
description: Retrieve a list of assets for the provided search parameters.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- $ref: '#/parameters/Azure.Core.FilterQueryParameter'
- $ref: '#/parameters/OrderByParameter'
- $ref: '#/parameters/Azure.Core.SkipQueryParameter'
- $ref: '#/parameters/Azure.Core.MaxPageSizeQueryParameter'
- $ref: '#/parameters/MarkParameter'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/PagedAssetResource'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
Assets_ListAssetResource:
$ref: ./examples/Assets_ListAssetResource_MaximumSet_Gen.json
x-ms-pageable:
nextLinkName: nextLink
summary: Microsoft Azure Get Assets
post:
operationId: microsoftAzureAssetsUpdateassets
tags:
- Assets
description: Update labels on assets matching the provided filter.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- $ref: '#/parameters/RequiredFilterParameter'
- name: body
in: body
required: true
schema:
$ref: '#/definitions/AssetUpdateData'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/Task'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
Assets_UpdateAssets:
$ref: ./examples/Assets_UpdateAssets_MaximumSet_Gen.json
summary: Microsoft Azure Post Assets
/assets/{assetId}:
get:
operationId: microsoftAzureAssetsGetassetresource
tags:
- Assets
description: Retrieve an asset by assetId.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: assetId
in: path
description: The system generated unique id for the resource.
required: true
type: string
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/AssetResource'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
Assets_GetAssetResource:
$ref: ./examples/Assets_GetAssetResource_MaximumSet_Gen.json
summary: Microsoft Azure Get Assets Assetid
/dataConnections:
get:
operationId: microsoftAzureDataconnectionsListdataconnection
tags:
- Data Connections
description: Retrieve a list of data connections.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- $ref: '#/parameters/Azure.Core.SkipQueryParameter'
- $ref: '#/parameters/Azure.Core.MaxPageSizeQueryParameter'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/PagedDataConnection'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DataConnections_ListDataConnection:
$ref: ./examples/DataConnections_ListDataConnection_MaximumSet_Gen.json
x-ms-pageable:
nextLinkName: nextLink
summary: Microsoft Azure Get Dataconnections
/dataConnections/{dataConnectionName}:
get:
operationId: microsoftAzureDataconnectionsGetdataconnection
tags:
- Data Connections
description: Retrieve a data connection with a given dataConnectionName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: dataConnectionName
in: path
description: The caller provided unique name for the resource.
required: true
type: string
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/DataConnection'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DataConnections_GetDataConnection:
$ref: ./examples/DataConnections_GetDataConnection_MaximumSet_Gen.json
summary: Microsoft Azure Get Dataconnections Dataconnectionname
put:
operationId: microsoftAzureDataconnectionsCreateorreplacedataconnection
tags:
- Data Connections
description: Create or replace a data connection with a given dataConnectionName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: dataConnectionName
in: path
description: The caller provided unique name for the resource.
required: true
type: string
- name: body
in: body
required: true
schema:
$ref: '#/definitions/DataConnectionData'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/DataConnection'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DataConnections_CreateOrReplaceDataConnection:
$ref: >-
./examples/DataConnections_CreateOrReplaceDataConnection_MaximumSet_Gen.json
summary: Microsoft Azure Put Dataconnections Dataconnectionname
delete:
operationId: microsoftAzureDataconnectionsDeletedataconnection
tags:
- Data Connections
description: Delete a data connection with a given dataConnectionName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: dataConnectionName
in: path
description: The caller provided unique name for the resource.
required: true
type: string
responses:
'204':
description: >-
There is no content to send for this request, but the headers may be
useful.
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DataConnections_DeleteDataConnection:
$ref: ./examples/DataConnections_DeleteDataConnection_MaximumSet_Gen.json
summary: Microsoft Azure Delete Dataconnections Dataconnectionname
/dataConnections:validate:
post:
operationId: microsoftAzureDataconnectionsValidatedataconnection
tags:
- Data Connections
description: Validate a data connection with a given dataConnectionName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: body
in: body
required: true
schema:
$ref: '#/definitions/DataConnectionData'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/ValidateResult'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DataConnections_ValidateDataConnection:
$ref: >-
./examples/DataConnections_ValidateDataConnection_MaximumSet_Gen.json
summary: Microsoft Azure Post Dataconnections:validate
/discoGroups:
get:
operationId: microsoftAzureDiscoverygroupsListdiscogroup
tags:
- Discovery Groups
description: Retrieve a list of discovery group for the provided search parameters.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- $ref: '#/parameters/Azure.Core.FilterQueryParameter'
- $ref: '#/parameters/Azure.Core.SkipQueryParameter'
- $ref: '#/parameters/Azure.Core.MaxPageSizeQueryParameter'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/PagedDiscoGroup'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DiscoveryGroups_ListDiscoGroup:
$ref: ./examples/DiscoveryGroups_ListDiscoGroup_MaximumSet_Gen.json
x-ms-pageable:
nextLinkName: nextLink
summary: Microsoft Azure Get Discogroups
/discoGroups/{groupName}:
get:
operationId: microsoftAzureDiscoverygroupsGetdiscogroup
tags:
- Discovery Groups
description: Retrieve a discovery group with a given groupName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: groupName
in: path
description: The caller provided unique name for the resource.
required: true
type: string
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/DiscoGroup'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DiscoveryGroups_GetDiscoGroup:
$ref: ./examples/DiscoveryGroups_GetDiscoGroup_MaximumSet_Gen.json
summary: Microsoft Azure Get Discogroups Groupname
put:
operationId: microsoftAzureDiscoverygroupsCreateorreplacediscogroup
tags:
- Discovery Groups
description: Create a discovery group with a given groupName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: groupName
in: path
description: The caller provided unique name for the resource.
required: true
type: string
- name: body
in: body
required: true
schema:
$ref: '#/definitions/DiscoGroupData'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/DiscoGroup'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DiscoveryGroups_CreateOrReplaceDiscoGroup:
$ref: >-
./examples/DiscoveryGroups_CreateOrReplaceDiscoGroup_MaximumSet_Gen.json
summary: Microsoft Azure Put Discogroups Groupname
/discoGroups/{groupName}:run:
post:
operationId: microsoftAzureDiscoverygroupsRundiscogroup
tags:
- Discovery Groups
description: Run a discovery group with a given groupName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: groupName
in: path
description: The caller provided unique name for the resource.
required: true
type: string
responses:
'204':
description: >-
There is no content to send for this request, but the headers may be
useful.
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DiscoveryGroups_RunDiscoGroup:
$ref: ./examples/DiscoveryGroups_RunDiscoGroup_MaximumSet_Gen.json
summary: Microsoft Azure Post Discogroups Groupname:run
/discoGroups/{groupName}/runs:
get:
operationId: microsoftAzureDiscoverygroupsListruns
tags:
- Discovery Groups
description: >-
Retrieve a collection of discovery run results for a discovery group
with a given groupName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- $ref: '#/parameters/Azure.Core.FilterQueryParameter'
- $ref: '#/parameters/Azure.Core.SkipQueryParameter'
- $ref: '#/parameters/Azure.Core.MaxPageSizeQueryParameter'
- $ref: '#/parameters/DiscoGroupNameParameter'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/DiscoRunPageResult'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DiscoveryGroups_ListRuns:
$ref: ./examples/DiscoveryGroups_ListRuns_MaximumSet_Gen.json
x-ms-pageable:
nextLinkName: nextLink
summary: Microsoft Azure Get Discogroups Groupname Runs
/discoGroups:validate:
post:
operationId: microsoftAzureDiscoverygroupsValidatediscogroup
tags:
- Discovery Groups
description: Validate a discovery group with a given groupName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: body
in: body
required: true
schema:
$ref: '#/definitions/DiscoGroupData'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/ValidateResult'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DiscoveryGroups_ValidateDiscoGroup:
$ref: ./examples/DiscoveryGroups_ValidateDiscoGroup_MaximumSet_Gen.json
summary: Microsoft Azure Post Discogroups:validate
/discoTemplates:
get:
operationId: microsoftAzureDiscoverytemplatesListdiscotemplate
tags:
- Discovery Templates
description: Retrieve a list of disco templates for the provided search parameters.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- $ref: '#/parameters/Azure.Core.FilterQueryParameter'
- $ref: '#/parameters/Azure.Core.SkipQueryParameter'
- $ref: '#/parameters/Azure.Core.MaxPageSizeQueryParameter'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/PagedDiscoTemplate'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DiscoveryTemplates_ListDiscoTemplate:
$ref: ./examples/DiscoveryTemplates_ListDiscoTemplate_MaximumSet_Gen.json
x-ms-pageable:
nextLinkName: nextLink
summary: Microsoft Azure Get Discotemplates
/discoTemplates/{templateId}:
get:
operationId: microsoftAzureDiscoverytemplatesGetdiscotemplate
tags:
- Discovery Templates
description: Retrieve a disco template with a given templateId.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: templateId
in: path
description: The system generated unique id for the resource.
required: true
type: string
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/DiscoTemplate'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
DiscoveryTemplates_GetDiscoTemplate:
$ref: ./examples/DiscoveryTemplates_GetDiscoTemplate_MaximumSet_Gen.json
summary: Microsoft Azure Get Discotemplates Templateid
/reports/assets:getBillable:
post:
operationId: microsoftAzureReportsGetbillable
tags:
- Reports
description: Get billable assets summary for the workspace.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/ReportBillableAssetSummaryResult'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
Reports_GetBillable:
$ref: ./examples/Reports_GetBillable_MaximumSet_Gen.json
summary: Microsoft Azure Post Reports Assets:getbillable
/reports/assets:getSnapshot:
post:
operationId: microsoftAzureReportsGetsnapshot
tags:
- Reports
description: >-
Get the most recent snapshot of asset summary values for the snapshot
request.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: body
in: body
required: true
schema:
$ref: '#/definitions/ReportAssetSnapshotRequest'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/ReportAssetSnapshotResult'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
Reports_GetSnapshot:
$ref: ./examples/Reports_GetSnapshot_MaximumSet_Gen.json
summary: Microsoft Azure Post Reports Assets:getsnapshot
/reports/assets:getSummary:
post:
operationId: microsoftAzureReportsGetsummary
tags:
- Reports
description: Get asset summary details for the summary request.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: body
in: body
required: true
schema:
$ref: '#/definitions/ReportAssetSummaryRequest'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/ReportAssetSummaryResult'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
Reports_GetSummary:
$ref: ./examples/Reports_GetSummary_MaximumSet_Gen.json
summary: Microsoft Azure Post Reports Assets:getsummary
/savedFilters:
get:
operationId: microsoftAzureSavedfiltersListsavedfilter
tags:
- Saved Filters
description: Retrieve a list of saved filters for the provided search parameters.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- $ref: '#/parameters/Azure.Core.FilterQueryParameter'
- $ref: '#/parameters/Azure.Core.SkipQueryParameter'
- $ref: '#/parameters/Azure.Core.MaxPageSizeQueryParameter'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/PagedSavedFilter'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
SavedFilters_ListSavedFilter:
$ref: ./examples/SavedFilters_ListSavedFilter_MaximumSet_Gen.json
x-ms-pageable:
nextLinkName: nextLink
summary: Microsoft Azure Get Savedfilters
/savedFilters/{filterName}:
get:
operationId: microsoftAzureSavedfiltersGetsavedfilter
tags:
- Saved Filters
description: Retrieve a saved filter by filterName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: filterName
in: path
description: The caller provided unique name for the resource.
required: true
type: string
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/SavedFilter'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
SavedFilters_GetSavedFilter:
$ref: ./examples/SavedFilters_GetSavedFilter_MaximumSet_Gen.json
summary: Microsoft Azure Get Savedfilters Filtername
put:
operationId: microsoftAzureSavedfiltersCreateorreplacesavedfilter
tags:
- Saved Filters
description: Create or replace a saved filter with a given filterName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: filterName
in: path
description: The caller provided unique name for the resource.
required: true
type: string
- name: body
in: body
required: true
schema:
$ref: '#/definitions/SavedFilterData'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/SavedFilter'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
SavedFilters_CreateOrReplaceSavedFilter:
$ref: >-
./examples/SavedFilters_CreateOrReplaceSavedFilter_MaximumSet_Gen.json
summary: Microsoft Azure Put Savedfilters Filtername
delete:
operationId: microsoftAzureSavedfiltersDeletesavedfilter
tags:
- Saved Filters
description: Delete a saved filter with a given filterName.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: filterName
in: path
description: The caller provided unique name for the resource.
required: true
type: string
responses:
'204':
description: >-
There is no content to send for this request, but the headers may be
useful.
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
SavedFilters_DeleteSavedFilter:
$ref: ./examples/SavedFilters_DeleteSavedFilter_MaximumSet_Gen.json
summary: Microsoft Azure Delete Savedfilters Filtername
/tasks:
get:
operationId: microsoftAzureTasksListtask
tags:
- Tasks
description: Retrieve a list of tasks for the provided search parameters.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- $ref: '#/parameters/Azure.Core.FilterQueryParameter'
- $ref: '#/parameters/OrderByParameter'
- $ref: '#/parameters/Azure.Core.SkipQueryParameter'
- $ref: '#/parameters/Azure.Core.MaxPageSizeQueryParameter'
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/PagedTask'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
Tasks_ListTask:
$ref: ./examples/Tasks_ListTask_MaximumSet_Gen.json
x-ms-pageable:
nextLinkName: nextLink
summary: Microsoft Azure Get Tasks
/tasks/{taskId}:
get:
operationId: microsoftAzureTasksGettask
tags:
- Tasks
description: Retrieve a task by taskId.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: taskId
in: path
description: The unique identifier of the task.
required: true
type: string
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/Task'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
Tasks_GetTask:
$ref: ./examples/Tasks_GetTask_MaximumSet_Gen.json
summary: Microsoft Azure Get Tasks Taskid
/tasks/{taskId}:cancel:
post:
operationId: microsoftAzureTasksCanceltask
tags:
- Tasks
description: Cancel a task by taskId.
parameters:
- $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter'
- name: taskId
in: path
description: The unique identifier of the task.
required: true
type: string
responses:
'200':
description: The request has succeeded.
schema:
$ref: '#/definitions/Task'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/Azure.Core.Foundations.ErrorResponse'
headers:
x-ms-error-code:
type: string
description: String error code indicating what went wrong.
x-ms-examples:
Tasks_CancelTask:
$ref: ./examples/Tasks_CancelTask_MaximumSet_Gen.json
summary: Microsoft Azure Post Tasks Taskid:cancel
definitions:
AlexaInfo:
type: object
properties:
alexaRank:
type: integer
format: int64
category:
type: string
firstSeen:
type: string
format: date-time
lastSeen:
type: string
format: date-time
count:
type: integer
format: int64
recent:
type: boolean
AsAsset:
type: object
properties:
asn:
type: integer
format: int64
asNames:
type: array
items:
$ref: '#/definitions/ObservedString'
x-ms-identifiers: []
orgNames:
type: array
items:
$ref: '#/definitions/ObservedString'
x-ms-identifiers: []
orgIds:
type: array
items:
$ref: '#/definitions/ObservedString'
x-ms-identifiers: []
countries:
type: array
items:
$ref: '#/definitions/ObservedString'
x-ms-identifiers: []
registries:
type: array
items:
$ref: '#/definitions/ObservedString'
x-ms-identifiers: []
sources:
type: array
items:
$ref: '#/definitions/Source'
x-ms-identifiers: []
firstSeen:
type: string
format: date-time
lastSeen:
type: string
format: date-time
count:
type: integer
format: int64
registrarCreatedAt:
type: array
items:
$ref: '#/definitions/ObservedLong'
x-m
# --- truncated at 32 KB (111 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/defender-easm-openapi-original.yml