Compliances - Get

Service:: Defender for Cloud

API-versie:: 2017-08-01-preview

Details van een specifieke naleving.

GET https://management.azure.com/{scope}/providers/Microsoft.Security/compliances/{complianceName}?api-version=2017-08-01-preview

URI-parameters

Name	In	Vereist	Type	Description
complianceName	path	True	string	naam van de naleving
scope	path	True	string	De volledig gekwalificeerde Azure Resource manager-identificatie van de resource.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	Compliance	Azure-operatie succesvol voltooid.
Other Status Codes	Common.CloudError	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Get security compliance data for a day

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/compliances/2018-01-01Z?api-version=2017-08-01-preview

Voorbeeldrespons

Statuscode:: 200

{
  "name": "2018-01-01Z",
  "type": "Microsoft.Security/compliances",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/compliances/2018-01-01Z",
  "properties": {
    "assessmentResult": [
      {
        "percentage": 77.77777777777779,
        "segmentType": "Compliant"
      }
    ],
    "assessmentTimestampUtcDate": "2018-01-01T00:00:00Z",
    "resourceCount": 18
  }
}

Definities

Name	Description
Common.CloudError	Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)
Common.CloudErrorBody	De foutdetails.
Compliance	Naleving van een bereik
ComplianceSegment	Een segment van een nalevingsevaluatie.
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Common.CloudError

Object

Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)

Name	Type	Description
error.additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
error.code	string	De foutcode.
error.details	Common.CloudErrorBody[]	De foutdetails.
error.message	string	Het foutbericht.
error.target	string	Het foutdoel.

Common.CloudErrorBody

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	Common.CloudErrorBody[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

Compliance

Object

Naleving van een bereik

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
name	string	De naam van de resource
properties.assessmentResult	ComplianceSegment[]	Een matrix van segment, de eigenlijk de nalevingsevaluatie.
properties.assessmentTimestampUtcDate	string (date-time)	De tijdstempel waarop de complianceberekening is uitgevoerd.
properties.resourceCount	integer (int32)	Het aantal resources van het opgegeven abonnement waarvoor de complianceberekening is uitgevoerd (vereist voor de berekening van beheergroepnaleving).
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ComplianceSegment

Object

Een segment van een nalevingsevaluatie.

Name	Type	Description
percentage	number (double)	De grootte (%) van het segment.
segmentType	string	Het segmenttype, bijvoorbeeld compatibel, niet-naleving, onvoldoende dekking, N/B, enzovoort.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.