你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Discovery Groups - Get Disco Group

检索具有给定 groupName 的发现组。

GET {endpoint}/discoGroups/{groupName}?api-version=2024-03-01-preview

URI 参数

名称 必需 类型 说明
endpoint
path True

string

托管所请求资源的终结点。 例如,https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}

groupName
path True

string

调用方为资源提供了唯一名称。

api-version
query True

string

要用于此操作的 API 版本。

响应

名称 类型 说明
200 OK

DiscoGroup

请求已成功。

Other Status Codes

Azure.Core.Foundations.ErrorResponse

意外的错误响应。

标头

x-ms-error-code: string

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
https://easm.defender.microsoft.com/.default

示例

DiscoveryGroups_GetDiscoGroup

示例请求

GET {endpoint}/discoGroups/ThisisaDiscoGroup?api-version=2024-03-01-preview

示例响应

{
  "id": "ThisisaDiscoGroup",
  "name": "ThisisaDiscoGroup",
  "displayName": "ThisisaDiscoGroup",
  "description": "This is a disco group",
  "tier": "advanced",
  "frequencyMilliseconds": 604800000,
  "seeds": [
    {
      "name": "thisisatest.microsoft.com",
      "kind": "host"
    }
  ],
  "excludes": [],
  "templateId": "123",
  "latestRun": {
    "startedDate": "2022-05-02T19:30:14.432+00:00",
    "state": "completed"
  },
  "createdDate": "2022-05-02T19:30:14.432+00:00"
}

定义

名称 说明
Azure.Core.Foundations.Error

错误对象。

Azure.Core.Foundations.ErrorResponse

包含错误详细信息的响应。

Azure.Core.Foundations.InnerError

包含有关错误的更具体信息的对象。 根据 Microsoft One API 指南 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses

DiscoGroup
DiscoRunResult

此迪斯科舞厅组的最新运行信息有限,如果组从未运行过,则为 null。

DiscoRunState

迪斯科舞厅运行的状态。

DiscoSource

用于驱动发现的源实体。

DiscoSourceKind

迪斯科源的类型。

Azure.Core.Foundations.Error

错误对象。

名称 类型 说明
code

string

服务器定义的一组错误代码中的一个。

details

Azure.Core.Foundations.Error[]

有关导致此项报告错误的特定错误的详细信息数组。

innererror

Azure.Core.Foundations.InnerError

一个 对象,该对象包含比当前对象更具体的错误信息。

message

string

错误的用户可读表示形式。

target

string

错误的目标。

Azure.Core.Foundations.ErrorResponse

包含错误详细信息的响应。

名称 类型 说明
error

Azure.Core.Foundations.Error

错误对象。

Azure.Core.Foundations.InnerError

包含有关错误的更具体信息的对象。 根据 Microsoft One API 指南 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses

名称 类型 说明
code

string

服务器定义的一组错误代码中的一个。

innererror

Azure.Core.Foundations.InnerError

内部错误。

DiscoGroup

名称 类型 说明
createdDate

string

迪斯科组的创建日期。

description

string

迪斯科舞厅组的说明。

displayName

string

可用于显示的名称。

excludes

DiscoSource[]

用于迪斯科组运行的排除列表,即要从发现算法中排除的资产。

frequencyMilliseconds

integer

迪斯科组应重新运行的频率(以毫秒为单位)。

id

string

系统为资源生成了唯一 ID。

latestRun

DiscoRunResult

此迪斯科舞厅组的最新运行信息有限,如果组从未运行过,则为 null。

name

string

调用方为资源提供了唯一名称。

names

string[]

用于迪斯科组运行的名称列表。

seeds

DiscoSource[]

用于迪斯科舞团运行的种子列表。

templateId

string

用于创建迪斯科组的迪斯科模板的唯一标识符。

tier

string

将影响用于迪斯科舞厅的算法的迪斯科组的层在此组中运行。

DiscoRunResult

此迪斯科舞厅组的最新运行信息有限,如果组从未运行过,则为 null。

名称 类型 说明
completedDate

string

系统完成迪斯科舞厅运行的日期。

excludes

DiscoSource[]

用于迪斯科舞厅运行的排除列表,即要从发现算法中排除的资产。

names

string[]

用于迪斯科舞会的名称列表。

seeds

DiscoSource[]

用于迪斯科舞会的种子列表。

startedDate

string

迪斯科舞厅运行实际由系统启动的日期。

state

DiscoRunState

迪斯科舞厅运行的状态。

submittedDate

string

在系统中创建迪斯科舞厅的日期。

tier

string

将影响用于迪斯科运行的算法的层。

totalAssetsFoundCount

integer

此迪斯科舞厅运行找到的资产总数。

DiscoRunState

迪斯科舞厅运行的状态。

名称 类型 说明
completed

string

failed

string

pending

string

running

string

DiscoSource

用于驱动发现的源实体。

名称 类型 说明
kind

DiscoSourceKind

迪斯科源的类型。

name

string

迪斯科舞厅源的名称。

DiscoSourceKind

迪斯科源的类型。

名称 类型 说明
as

string

attribute

string

contact

string

domain

string

host

string

ipBlock

string