Security Contacts - Get
Alapértelmezett biztonsági kapcsolatfelvételi konfigurációk lekérése az előfizetéshez
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/securityContacts/{securityContactName}?api-version=2020-01-01-preview
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
security
|
path | True |
string |
A biztonsági kapcsolattartó objektum neve |
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
Get a security contact
Sample Request
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts/default?api-version=2020-01-01-preview
Sample Response
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts/default",
"name": "default",
"type": "Microsoft.Security/securityContacts",
"properties": {
"notificationsByRole": {
"state": "On",
"roles": [
"Owner"
]
},
"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 azure Resource Manager API-k gyakori hibaválasza a meghiúsult 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 az e-mail-értesítésekként küldendő minimális riasztási súlyosságot |
Notifications |
Meghatározza, hogy küldjön-e e e-mail-értesítéseket Microsoft Defender felhőhöz 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. |
state |
Meghatározza, hogy a rendszer e-mail-értesítéseket küldjön-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 az e-mail-értesítésekként küldendő minimális riasztási súlyosságot |
|
state |
Meghatározza, hogy a rendszer e-mail-értesítéseket küldjön-e az új biztonsági riasztásokról |
CloudError
Az azure Resource Manager API-k gyakori hibaválasza a meghiúsult 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 hiba célja. |
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 hiba célja. |
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 adattípus. |
minimalSeverity
Meghatározza az e-mail-értesítésekként küldendő minimális riasztási súlyosságot
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 Microsoft Defender felhőhöz 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üldjön-e e e-mail-értesítéseket az AMicrosoft 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:
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 kapcsolattartóban meghatározott konfigurációk alapján kapnak értesítéseket Microsoft Defender a Felhőhöz. |
properties.notificationsByRole |
Meghatározza, hogy küldjön-e e e-mail-értesítéseket Microsoft Defender felhőhöz 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 |
state
Meghatározza, hogy a rendszer e-mail-értesítéseket küldjön-e az új biztonsági riasztásokról
Name | Típus | Description |
---|---|---|
Off |
string |
Ne kapjon értesítéseket az új riasztásokról |
On |
string |
Értesítések lekérése új riasztásokról |