Workspace Manager Assignments - Create Or Update

Referenz

Dienst:: Sentinel

API-Version:: 2024-01-01-preview

Erstellt oder aktualisiert eine Arbeitsbereichs-Manager-Zuweisung.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/workspaceManagerAssignments/{workspaceManagerAssignmentName}?api-version=2024-01-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string	Hierbei handelt es sich um die ID des Zielabonnements.
workspaceManagerAssignmentName	path	True	string	Der Name der Arbeitsbereichs-Manager-Zuweisung RegEx-Muster: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
workspaceName	path	True	string	Den Namen des Arbeitsbereichs RegEx-Muster: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.items	True	assignmentItem[]	Liste der Ressourcen, die in dieser Arbeitsbereichs-Manager-Zuweisung enthalten sind
properties.targetResourceName	True	string	Der Ressourcenname der Arbeitsbereichs-Manager-Gruppe, auf die die Arbeitsbereichs-Manager-Zuweisung ausgerichtet ist.

Antworten

Name	Typ	Beschreibung
200 OK	WorkspaceManagerAssignment	OK, erstellt oder aktualisiert instance
201 Created	WorkspaceManagerAssignment	Erstellt
Other Status Codes	ErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Creates or updates a workspace manager assignment.

Beispielanforderung

HTTP

PUT https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/workspaceManagerAssignments/47cdc5f5-37c4-47b5-bd5f-83c84b8bdd58?api-version=2024-01-01-preview

{
  "properties": {
    "items": [
      {
        "resourceId": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspac-es/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/microsoftSecurityIncidentCreationRuleExampleOne"
      },
      {
        "resourceId": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspac-es/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/microsoftSecurityIncidentCreationRuleExampleTwo"
      }
    ],
    "targetResourceName": "37207a7a-3b8a-438f-a559-c7df400e1b96"
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/workspaceManagerAssignments/47cdc5f5-37c4-47b5-bd5f-83c84b8bdd58",
  "etag": "\"190057d0-0000-0d00-0000-5c6f5adb0000\"",
  "name": "47cdc5f5-37c4-47b5-bd5f-83c84b8bdd58",
  "type": "Microsoft.SecurityInsights/workspaceManagerAssignments",
  "properties": {
    "items": [
      {
        "resourceId": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspac-es/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/microsoftSecurityIncidentCreationRuleExampleOne"
      },
      {
        "resourceId": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspac-es/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/microsoftSecurityIncidentCreationRuleExampleTwo"
      }
    ],
    "targetResourceName": "37207a7a-3b8a-438f-a559-c7df400e1b96"
  }
}

Statuscode:: 201

{
  "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/workspaceManagerAssignments/47cdc5f5-37c4-47b5-bd5f-83c84b8bdd58",
  "etag": "\"190057d0-0000-0d00-0000-5c6f5adb0000\"",
  "name": "47cdc5f5-37c4-47b5-bd5f-83c84b8bdd58",
  "type": "Microsoft.SecurityInsights/workspaceManagerAssignments",
  "properties": {
    "items": [
      {
        "resourceId": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspac-es/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/microsoftSecurityIncidentCreationRuleExampleOne"
      },
      {
        "resourceId": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspac-es/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/microsoftSecurityIncidentCreationRuleExampleTwo"
      }
    ],
    "targetResourceName": "37207a7a-3b8a-438f-a559-c7df400e1b96"
  }
}

Definitionen

Name	Beschreibung
assignmentItem	Eine Entität, die ein Inhaltselement beschreibt.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
provisioningState	Status des letzten Auftrags, der dieser Zuweisung zugeordnet ist
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
WorkspaceManagerAssignment	Die Arbeitsbereichs-Manager-Zuweisung

assignmentItem

Eine Entität, die ein Inhaltselement beschreibt.

Name	Typ	Beschreibung
resourceId	string	Die Ressourcen-ID des Inhaltselements

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

provisioningState

Status des letzten Auftrags, der dieser Zuweisung zugeordnet ist

Name	Typ	Beschreibung
Canceled	string	Der Auftrag wurde abgebrochen.
Failed	string	Fehler beim Auftrag
InProgress	string	Der Auftrag wird ausgeführt.
Succeeded	string	Der Auftrag war erfolgreich.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.