Watchlist Items - Create Or Update
Créer ou mettre à jour un élément watchlist.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/watchlists/{watchlistAlias}/watchlistItems/{watchlistItemId}?api-version=2024-03-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
subscription
|
path | True |
string |
ID de l’abonnement cible. |
watchlist
|
path | True |
string |
Alias watchlist |
watchlist
|
path | True |
string |
ID de l’élément watchlist (GUID) |
workspace
|
path | True |
string |
Nom de l’espace de travail. Regex pattern: |
api-version
|
query | True |
string |
Version de l’API à utiliser pour cette opération. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
properties.itemsKeyValue | True |
object |
paires clé-valeur pour un élément watchlist |
etag |
string |
Etag de la ressource Azure |
|
properties.created |
string |
Heure à laquelle l’élément watchlist a été créé |
|
properties.createdBy |
Décrit un utilisateur qui a créé l’élément watchlist |
||
properties.entityMapping |
object |
paires clé-valeur pour un mappage d’entité d’élément watchlist |
|
properties.isDeleted |
boolean |
Indicateur qui indique si l’élément watchlist est supprimé ou non |
|
properties.tenantId |
string |
TenantId auquel appartient l’élément watchlist |
|
properties.updated |
string |
La dernière fois que l’élément watchlist a été mis à jour |
|
properties.updatedBy |
Décrit un utilisateur qui a mis à jour l’élément watchlist |
||
properties.watchlistItemId |
string |
ID (guid) de l’élément watchlist |
|
properties.watchlistItemType |
string |
Type de l’élément watchlist |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Ok |
|
201 Created |
Date de création |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
Create or update a watchlist item.
Sample Request
PUT https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/watchlists/highValueAsset/watchlistItems/82ba292c-dc97-4dfc-969d-d4dd9e666842?api-version=2024-03-01
{
"etag": "0300bf09-0000-0000-0000-5c37296e0000",
"properties": {
"itemsKeyValue": {
"Gateway subnet": "10.0.255.224/27",
"Web Tier": "10.0.1.0/24",
"Business tier": "10.0.2.0/24",
"Data tier": "10.0.2.0/24",
"Private DMZ in": "10.0.0.0/27",
"Public DMZ out": "10.0.0.96/27"
}
}
}
Sample Response
{
"id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/Watchlists/highValueAsset/WatchlistItems/82ba292c-dc97-4dfc-969d-d4dd9e666842",
"etag": "0300bf09-0000-0000-0000-5c37296e0000",
"type": "Microsoft.SecurityInsights/Watchlists/WatchlistItems",
"properties": {
"watchlistItemType": "watchlist-item",
"watchlistItemId": "82ba292c-dc97-4dfc-969d-d4dd9e666842",
"tenantId": "4008512e-1d30-48b2-9ee2-d3612ed9d3ea",
"isDeleted": false,
"created": "2020-11-15T04:58:56.0748363+00:00",
"updated": "2020-11-16T16:05:20+00:00",
"createdBy": {
"objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
"email": "john@contoso.com",
"name": "john doe"
},
"updatedBy": {
"objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
"email": "john@contoso.com",
"name": "john doe"
},
"itemsKeyValue": {
"Gateway subnet": "10.0.255.224/27",
"Web Tier": "10.0.1.0/24",
"Business tier": "10.0.2.0/24",
"Data tier": "10.0.2.0/24",
"Private DMZ in": "10.0.0.0/27",
"Public DMZ out": "10.0.0.96/27"
}
}
}
{
"id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/Watchlists/highValueAsset/WatchlistItems/82ba292c-dc97-4dfc-969d-d4dd9e666842",
"etag": "0300bf09-0000-0000-0000-5c37296e0000",
"type": "Microsoft.SecurityInsights/Watchlists/WatchlistItems",
"properties": {
"watchlistItemType": "watchlist-item",
"watchlistItemId": "82ba292c-dc97-4dfc-969d-d4dd9e666842",
"tenantId": "4008512e-1d30-48b2-9ee2-d3612ed9d3ea",
"isDeleted": false,
"created": "2020-11-15T04:58:56.0748363+00:00",
"updated": "2020-11-16T16:05:20+00:00",
"createdBy": {
"objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
"email": "john@contoso.com",
"name": "john doe"
},
"updatedBy": {
"objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
"email": "john@contoso.com",
"name": "john doe"
},
"itemsKeyValue": {
"Gateway subnet": "10.0.255.224/27",
"Web Tier": "10.0.1.0/24",
"Business tier": "10.0.2.0/24",
"Data tier": "10.0.2.0/24",
"Private DMZ in": "10.0.0.0/27",
"Public DMZ out": "10.0.0.96/27"
}
}
}
Définitions
Nom | Description |
---|---|
Cloud |
Structure de réponse d’erreur. |
Cloud |
Détails de l’erreur. |
created |
Type d’identité qui a créé la ressource. |
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
User |
Informations utilisateur ayant effectué une action |
Watchlist |
Représente un élément watchlist dans Azure Security Insights. |
CloudError
Structure de réponse d’erreur.
Nom | Type | Description |
---|---|---|
error |
Données d’erreur |
CloudErrorBody
Détails de l’erreur.
Nom | Type | Description |
---|---|---|
code |
string |
Identificateur de l'erreur. Les codes sont invariants et sont destinés à être consommés par programmation. |
message |
string |
Message décrivant l’erreur, destiné à être affiché dans une interface utilisateur. |
createdByType
Type d’identité qui a créé la ressource.
Nom | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
Nom | Type | Description |
---|---|---|
createdAt |
string |
Horodatage de la création de ressources (UTC). |
createdBy |
string |
Identité qui a créé la ressource. |
createdByType |
Type d’identité qui a créé la ressource. |
|
lastModifiedAt |
string |
Horodatage de la dernière modification de la ressource (UTC) |
lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |
UserInfo
Informations utilisateur ayant effectué une action
Nom | Type | Description |
---|---|---|
string |
L’e-mail de l’utilisateur. |
|
name |
string |
Nom de l'utilisateur. |
objectId |
string |
ID d’objet de l’utilisateur. |
WatchlistItem
Représente un élément watchlist dans Azure Security Insights.
Nom | Type | Description |
---|---|---|
etag |
string |
Etag de la ressource Azure |
id |
string |
ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
nom de la ressource. |
properties.created |
string |
Heure à laquelle l’élément watchlist a été créé |
properties.createdBy |
Décrit un utilisateur qui a créé l’élément watchlist |
|
properties.entityMapping |
object |
paires clé-valeur pour un mappage d’entité d’élément watchlist |
properties.isDeleted |
boolean |
Indicateur qui indique si l’élément watchlist est supprimé ou non |
properties.itemsKeyValue |
object |
paires clé-valeur pour un élément watchlist |
properties.tenantId |
string |
TenantId auquel appartient l’élément watchlist |
properties.updated |
string |
La dernière fois que l’élément watchlist a été mis à jour |
properties.updatedBy |
Décrit un utilisateur qui a mis à jour l’élément watchlist |
|
properties.watchlistItemId |
string |
ID (guid) de l’élément watchlist |
properties.watchlistItemType |
string |
Type de l’élément watchlist |
systemData |
Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy. |
|
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |