Advanced Threat Protection - Create

Usługa:

Defender for Cloud

Wersja interfejsu API:

2019-01-01

Tworzy lub aktualizuje ustawienia usługi Advanced Threat Protection w określonym zasobie.

PUT https://management.azure.com/{resourceId}/providers/Microsoft.Security/advancedThreatProtectionSettings/current?api-version=2019-01-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceId	path	True	string	W pełni kwalifikowany identyfikator menedżera zasobów Azure zasobu.
settingName	path	True	AdvancedThreatProtectionSettingName	Nazwa ustawienia usługi Advanced Threat Protection.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
properties.isEnabled	boolean	Wskazuje, czy usługa Advanced Threat Protection jest włączona.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AdvancedThreatProtectionSetting	Operacja platformy Azure została zakończona pomyślnie.
Other Status Codes	Common.CloudError	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Creates or updates the Advanced Threat Protection settings on a specified resource.

Przykładowe żądanie

HTTP

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount/providers/Microsoft.Security/advancedThreatProtectionSettings/current?api-version=2019-01-01

{
  "name": "current",
  "type": "Microsoft.Security/advancedThreatProtectionSettings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount/providers/Microsoft.Security/advancedThreatProtectionSettings/current",
  "properties": {
    "isEnabled": true
  }
}

Przykładowa odpowiedź

Kod stanu:

200

{
  "name": "current",
  "type": "Microsoft.Security/advancedThreatProtectionSettings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount/providers/Microsoft.Security/advancedThreatProtectionSettings/current",
  "properties": {
    "isEnabled": true
  }
}

Definicje

Nazwa	Opis
AdvancedThreatProtectionSetting	Zasób usługi Advanced Threat Protection.
AdvancedThreatProtectionSettingName	Nazwa ustawienia usługi Advanced Threat Protection.
Common.CloudError	Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).
Common.CloudErrorBody	Szczegóły błędu.
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AdvancedThreatProtectionSetting

Objekt

Zasób usługi Advanced Threat Protection.

Nazwa	Typ	Opis
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nazwa zasobu
properties.isEnabled	boolean	Wskazuje, czy usługa Advanced Threat Protection jest włączona.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

AdvancedThreatProtectionSettingName

Wyliczenie

Nazwa ustawienia usługi Advanced Threat Protection.

Wartość	Opis
current

Common.CloudError

Objekt

Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

Nazwa	Typ	Opis
error.additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
error.code	string	Kod błędu.
error.details	Common.CloudErrorBody[]	Szczegóły błędu.
error.message	string	Komunikat o błędzie.
error.target	string	Element docelowy błędu.

Common.CloudErrorBody

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	Common.CloudErrorBody[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.