Security Contacts - List
Az előfizetés összes biztonsági partnerkonfigurációjának listázása
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/securityContacts?api-version=2020-01-01-preview
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
subscription
|
path | True |
string |
Azure-előfizetés azonosítója Regex pattern: |
api-version
|
query | True |
string |
A művelet API-verziója |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
List security contact data
Sample Request
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts?api-version=2020-01-01-preview
Sample Response
{
"value": [
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContact/default",
"name": "default",
"type": "Microsoft.Security/securityContact",
"properties": {
"notificationsByRole": {
"state": "On",
"roles": [
"Owner",
"Admin"
]
},
"emails": "john@contoso.com;Jane@contoso.com",
"phone": "(214)275-4038",
"alertNotifications": {
"state": "On",
"minimalSeverity": "Low"
}
}
}
]
}
Definíciók
Name | Description |
---|---|
Alert |
Meghatározza, hogy küldjön-e e e-mail-értesítéseket az új biztonsági riasztásokról |
Cloud |
Az összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.) |
Cloud |
A hiba részletei. |
Error |
Az erőforrás-kezelési hiba további információi. |
minimal |
Meghatározza a riasztások minimális súlyosságát, amely e-mail-értesítésként lesz elküldve |
Notifications |
Meghatározza, hogy küldjön-e e e-mail-értesítéseket a Microsoft Defender for Cloudból az előfizetésben meghatározott RBAC-szerepkörökkel rendelkező személyeknek. |
roles |
Meghatározza, hogy mely RBAC-szerepkörök kapnak e-mail-értesítéseket Microsoft Defender a Felhőhöz. Az engedélyezett RBAC-szerepkörök listája: |
Security |
A felhőhöz készült Microsoft Defender érkező értesítések kapcsolattartási adatai és konfigurációi. |
Security |
A biztonsági partnerek válaszainak listája |
state |
Meghatározza, hogy a rendszer e-mail-értesítéseket küld-e az új biztonsági riasztásokról |
AlertNotifications
Meghatározza, hogy küldjön-e e e-mail-értesítéseket az új biztonsági riasztásokról
Name | Típus | Description |
---|---|---|
minimalSeverity |
Meghatározza a riasztások minimális súlyosságát, amely e-mail-értesítésként lesz elküldve |
|
state |
Meghatározza, hogy a rendszer e-mail-értesítéseket küld-e az új biztonsági riasztásokról |
CloudError
Az összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)
Name | Típus | Description |
---|---|---|
error.additionalInfo |
A hiba további információi. |
|
error.code |
string |
A hibakód. |
error.details |
A hiba részletei. |
|
error.message |
string |
A hibaüzenet. |
error.target |
string |
A hibacél. |
CloudErrorBody
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
minimalSeverity
Meghatározza a riasztások minimális súlyosságát, amely e-mail-értesítésként lesz elküldve
Name | Típus | Description |
---|---|---|
High |
string |
Értesítések lekérése nagy súlyosságú új riasztásokról |
Low |
string |
Ne kapjon értesítéseket alacsony, közepes vagy nagy súlyosságú új riasztásokról |
Medium |
string |
Értesítések lekérése közepes vagy nagy súlyosságú új riasztásokról |
NotificationsByRole
Meghatározza, hogy küldjön-e e e-mail-értesítéseket a Microsoft Defender for Cloudból az előfizetésben meghatározott RBAC-szerepkörökkel rendelkező személyeknek.
Name | Típus | Description |
---|---|---|
roles |
roles[] |
Meghatározza, hogy mely RBAC-szerepkörök kapnak e-mail-értesítéseket Microsoft Defender a Felhőhöz. Az engedélyezett RBAC-szerepkörök listája: |
state |
Meghatározza, hogy küld-e e e-mail-értesítéseket az AMicrosoft Defender for Cloudtól az előfizetésben meghatározott RBAC-szerepkörökkel rendelkező személyeknek. |
roles
Meghatározza, hogy mely RBAC-szerepkörök kapnak e-mail-értesítéseket Microsoft Defender a Felhőhöz. Az engedélyezett RBAC-szerepkörök listája:
Name | Típus | Description |
---|---|---|
AccountAdmin |
string |
Ha engedélyezve van, küldjön értesítést az új riasztásokról a fiókadminisztrátornak |
Contributor |
string |
Ha engedélyezve van, küldjön értesítést az új riasztásokról az előfizetés közreműködőinek |
Owner |
string |
Ha engedélyezve van, küldjön értesítést az új riasztásokról az előfizetés tulajdonosainak |
ServiceAdmin |
string |
Ha engedélyezve van, küldjön értesítést az új riasztásokról a szolgáltatás rendszergazdáinak |
SecurityContact
A felhőhöz készült Microsoft Defender érkező értesítések kapcsolattartási adatai és konfigurációi.
Name | Típus | Description |
---|---|---|
id |
string |
Erőforrás-azonosító |
name |
string |
Erőforrás neve |
properties.alertNotifications |
Meghatározza, hogy küldjön-e e e-mail-értesítéseket az új biztonsági riasztásokról |
|
properties.emails |
string |
Azon e-mail-címek listája, amelyek a biztonsági partnerben meghatározott konfigurációk alapján kapnak értesítéseket a felhőhöz Microsoft Defender. |
properties.notificationsByRole |
Meghatározza, hogy küldjön-e e e-mail-értesítéseket a Microsoft Defender for Cloudból az előfizetésben meghatározott RBAC-szerepkörökkel rendelkező személyeknek. |
|
properties.phone |
string |
A biztonsági partner telefonszáma |
type |
string |
Erőforrás típusa |
SecurityContactList
A biztonsági partnerek válaszainak listája
Name | Típus | Description |
---|---|---|
nextLink |
string |
A következő oldal lekéréséhez az URI. |
value |
Biztonsági partnerek listája |
state
Meghatározza, hogy a rendszer e-mail-értesítéseket küld-e az új biztonsági riasztásokról
Name | Típus | Description |
---|---|---|
Off |
string |
Nem kap értesítéseket az új riasztásokról |
On |
string |
Értesítések lekérése új riasztásokról |