Standard Assignments - Create

Service:

Defender for Cloud

API-versie:

2024-08-01

Met deze bewerking maakt of werkt u een standaardtoewijzing bij met het opgegeven bereik en de opgegeven naam. Standaardtoewijzingen zijn van toepassing op alle resources die binnen hun bereik vallen. Wanneer u bijvoorbeeld een beleid toewijst op het bereik van de resourcegroep, is dat beleid van toepassing op alle resources in de groep.

PUT https://management.azure.com/{resourceId}/providers/Microsoft.Security/standardAssignments/{standardAssignmentName}?api-version=2024-08-01

URI-parameters

Name	In	Vereist	Type	Description
resourceId	path	True	string	De id van de resource.
standardAssignmentName	path	True	string pattern: [{]?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$	De toewijzingssleutel voor standaardtoewijzingen - unieke sleutel voor de standaardtoewijzing
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
properties.assignedStandard	AssignedStandardItem	Standaarditem met sleutel zoals toegepast op deze standaardtoewijzing voor het opgegeven bereik
properties.attestationData	AttestationData	Aanvullende gegevens over toewijzing met attest-effect
properties.description	string	Beschrijving van de standardAssignment
properties.displayName	string	Weergavenaam van de standardAssignment
properties.effect	effect	Verwacht effect van deze toewijzing (audit/vrijgesteld/attest)
properties.excludedScopes	string[]	Uitgesloten bereiken, de afstammelingen van het bereik filteren (op beheerbereiken)
properties.exemptionData	ExemptionData	Aanvullende gegevens over toewijzing met uitzonderingseffect
properties.expiresOn	string (date-time)	Vervaldatum van deze toewijzing als een volledige ISO-datum
properties.metadata	StandardAssignmentMetadata	De standaardtoewijzingsmetagegevens.

Antwoorden

Name	Type	Description
200 OK	StandardAssignment	OK - Standaardtoewijzing is bijgewerkt
201 Created	StandardAssignment	Gemaakt: retourneert informatie over de nieuwe standaardtoewijzing.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

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

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Put an audit standard assignment

Put exemption standard assignment

Put an audit standard assignment

Voorbeeldaanvraag

HTTP

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

{
  "properties": {
    "displayName": "ASC Default",
    "description": "Set of policies monitored by Azure Security Center for cross cloud",
    "assignedStandard": {
      "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
    },
    "effect": "Audit",
    "excludedScopes": []
  }
}

Java

import com.azure.resourcemanager.security.models.AssignedStandardItem;
import com.azure.resourcemanager.security.models.Effect;
import java.util.Arrays;

/**
 * Samples for StandardAssignments Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/StandardAssignments/
     * PutStandardAssignment.json
     */
    /**
     * Sample code: Put an audit standard assignment.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void putAnAuditStandardAssignment(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.standardAssignments().define("1f3afdf9-d0c9-4c3d-847f-89da613e70a8")
            .withExistingResourceId("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23").withDisplayName("ASC Default")
            .withDescription("Set of policies monitored by Azure Security Center for cross cloud")
            .withAssignedStandard(new AssignedStandardItem()
                .withId("/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"))
            .withEffect(Effect.AUDIT).withExcludedScopes(Arrays.asList()).create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/standardAssignments",
  "properties": {
    "displayName": "ASC Default",
    "description": "Set of policies monitored by Azure Security Center for cross cloud",
    "assignedStandard": {
      "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
    },
    "effect": "Audit",
    "excludedScopes": [],
    "metadata": {
      "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "createdOn": "2022-11-10T08:31:26.7993124Z",
      "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
    }
  }
}

Statuscode:

201

{
  "id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/standardAssignments",
  "properties": {
    "displayName": "ASC Default",
    "description": "Set of policies monitored by Azure Security Center for cross cloud",
    "assignedStandard": {
      "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
    },
    "effect": "Audit",
    "excludedScopes": [],
    "metadata": {
      "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "createdOn": "2022-11-10T08:31:26.7993124Z",
      "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
    }
  }
}

Put exemption standard assignment

Voorbeeldaanvraag

HTTP

PUT https://management.azure.com/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/ANAT_TEST_RG/providers/Microsoft.Compute/virtualMachines/anatTestE2LA/providers/Microsoft.Security/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

{
  "properties": {
    "displayName": "Test exemption",
    "description": "Exemption description",
    "assignedStandard": {
      "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
    },
    "effect": "Exempt",
    "expiresOn": "2022-05-01T19:50:47.083633Z",
    "exemptionData": {
      "exemptionCategory": "waiver",
      "assignedAssessment": {
        "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
      }
    }
  }
}

Java

import com.azure.resourcemanager.security.models.AssignedAssessmentItem;
import com.azure.resourcemanager.security.models.AssignedStandardItem;
import com.azure.resourcemanager.security.models.Effect;
import com.azure.resourcemanager.security.models.ExemptionCategory;
import com.azure.resourcemanager.security.models.StandardAssignmentPropertiesExemptionData;
import java.time.OffsetDateTime;

/**
 * Samples for StandardAssignments Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/StandardAssignments/
     * PutExemptionStandardAssignment.json
     */
    /**
     * Sample code: Put exemption standard assignment.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void putExemptionStandardAssignment(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.standardAssignments().define("1f3afdf9-d0c9-4c3d-847f-89da613e70a8").withExistingResourceId(
            "subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/ANAT_TEST_RG/providers/Microsoft.Compute/virtualMachines/anatTestE2LA")
            .withDisplayName("Test exemption").withDescription("Exemption description")
            .withAssignedStandard(new AssignedStandardItem()
                .withId("/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"))
            .withEffect(Effect.EXEMPT).withExpiresOn(OffsetDateTime.parse("2022-05-01T19:50:47.083633Z"))
            .withExemptionData(
                new StandardAssignmentPropertiesExemptionData().withExemptionCategory(ExemptionCategory.WAIVER)
                    .withAssignedAssessment(new AssignedAssessmentItem().withAssessmentKey("fakeTokenPlaceholder")))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "id": "/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/ANAT_TEST_RG/providers/Microsoft.Compute/virtualMachines/anatTestE2LA/Microsoft.Security/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/standardAssignments",
  "properties": {
    "displayName": "Test exemption",
    "description": "Exemption description",
    "assignedStandard": {
      "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
    },
    "effect": "Exempt",
    "expiresOn": "2022-05-01T19:50:47.083633Z",
    "exemptionData": {
      "exemptionCategory": "waiver",
      "assignedAssessment": {
        "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
      }
    },
    "metadata": {
      "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "createdOn": "2022-11-10T08:31:26.7993124Z",
      "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
    }
  }
}

Statuscode:

201

{
  "id": "/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/ANAT_TEST_RG/providers/Microsoft.Compute/virtualMachines/anatTestE2LA/Microsoft.Security/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/standardAssignments",
  "properties": {
    "displayName": "Test exemption",
    "description": "Exemption description",
    "assignedStandard": {
      "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
    },
    "effect": "Exempt",
    "expiresOn": "2022-05-01T19:50:47.083633Z",
    "exemptionData": {
      "exemptionCategory": "waiver",
      "assignedAssessment": {
        "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
      }
    },
    "metadata": {
      "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "createdOn": "2022-11-10T08:31:26.7993124Z",
      "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
    }
  }
}

Definities

Name	Description
AssignedAssessmentItem	De eigenschappen van een naslaginformatie over beveiligingsevaluatieobjecten beschrijven (op sleutel)
AssignedStandardItem	De eigenschappen van een standaardtoewijzingsobjectverwijzing beschrijven
attestationComplianceState	Attest-categorie van deze toewijzing
AttestationData	Aanvullende gegevens over toewijzing met attest-effect
AttestationEvidence	De eigenschappen van een toewijzingsverklaring beschrijven
effect	Verwacht effect van deze toewijzing (audit/vrijgesteld/attest)
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
exemptionCategory	Uitzonderingscategorie van deze toewijzing
ExemptionData	Aanvullende gegevens over toewijzing met uitzonderingseffect
StandardAssignment	Beveiligingstoewijzing voor een resourcegroep binnen een bepaald bereik
StandardAssignmentMetadata	De standaardtoewijzingsmetagegevens

AssignedAssessmentItem

Object

De eigenschappen van een naslaginformatie over beveiligingsevaluatieobjecten beschrijven (op sleutel)

Name	Type	Description
assessmentKey	string	Unieke sleutel voor een beveiligingsevaluatieobject

AssignedStandardItem

Object

De eigenschappen van een standaardtoewijzingsobjectverwijzing beschrijven

Name	Type	Description
id	string	Volledige resourceId van het Object Microsoft.Security/standard

attestationComplianceState

Inventarisatie

Attest-categorie van deze toewijzing

Waarde	Description
compliant
nonCompliant
unknown

AttestationData

Object

Aanvullende gegevens over toewijzing met attest-effect

Name	Type	Description
assignedAssessment	AssignedAssessmentItem	Onderdeelitem met sleutel zoals toegepast op deze standaardtoewijzing voor het opgegeven bereik
complianceDate	string (date-time)	Nalevingsdatum attestation
complianceState	attestationComplianceState	Attest-categorie van deze toewijzing
evidence	AttestationEvidence[]	Matrix van koppelingen naar attestation-bewijs

AttestationEvidence

Object

De eigenschappen van een toewijzingsverklaring beschrijven

Name	Type	Description
description	string	De beschrijving van het bewijs
sourceUrl	string	De bron-URL van het bewijs

effect

Inventarisatie

Verwacht effect van deze toewijzing (audit/vrijgesteld/attest)

Waarde	Description
Attest
Audit
Exempt

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

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

ErrorDetail

Object

De foutdetails.

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

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

exemptionCategory

Inventarisatie

Uitzonderingscategorie van deze toewijzing

Waarde	Description
mitigated
waiver

ExemptionData

Object

Aanvullende gegevens over toewijzing met uitzonderingseffect

Name	Type	Description
assignedAssessment	AssignedAssessmentItem	Onderdeelitem met sleutel zoals toegepast op deze standaardtoewijzing voor het opgegeven bereik
exemptionCategory	exemptionCategory	Uitzonderingscategorie van deze toewijzing

StandardAssignment

Object

Beveiligingstoewijzing voor een resourcegroep binnen een bepaald bereik

Name	Type	Description
id	string	Resource-id
name	string	Resourcenaam
properties.assignedStandard	AssignedStandardItem	Standaarditem met sleutel zoals toegepast op deze standaardtoewijzing voor het opgegeven bereik
properties.attestationData	AttestationData	Aanvullende gegevens over toewijzing met attest-effect
properties.description	string	Beschrijving van de standardAssignment
properties.displayName	string	Weergavenaam van de standardAssignment
properties.effect	effect	Verwacht effect van deze toewijzing (audit/vrijgesteld/attest)
properties.excludedScopes	string[]	Uitgesloten bereiken, de afstammelingen van het bereik filteren (op beheerbereiken)
properties.exemptionData	ExemptionData	Aanvullende gegevens over toewijzing met uitzonderingseffect
properties.expiresOn	string (date-time)	Vervaldatum van deze toewijzing als een volledige ISO-datum
properties.metadata	StandardAssignmentMetadata	De standaardtoewijzingsmetagegevens.
type	string	Resourcetype

StandardAssignmentMetadata

Object

De standaardtoewijzingsmetagegevens

Name	Type	Description
createdBy	string	Standaardtoewijzing gemaakt door object-id (GUID)
createdOn	string (date-time)	Aanmaakdatum van standaardtoewijzing
lastUpdatedBy	string	Standaardtoewijzing laatst bijgewerkt op object-id (GUID)
lastUpdatedOn	string (date-time)	Datum van laatste update van standaardtoewijzing