Standard Assignments - Get

Referentie

Service:: Defender for Cloud

API-versie:: 2024-08-01

Hiermee haalt u een standaardtoewijzing op.
Met deze bewerking wordt één standaardtoewijzing opgehaald, op basis van de naam en het bereik waarvoor deze is gemaakt.

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

URI-parameters

Name In Vereist Type Description

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

resourceId

path

True

string

De id van de resource.

standardAssignmentName

path

True

string

De toewijzingssleutel voor standaardtoewijzingen - unieke sleutel voor de standaardtoewijzing

Regex-patroon: [{]?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$

api-version

query

True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	StandardAssignment	Retourneert informatie over de 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

Retrieve a standard assignment

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01


/**
 * Samples for StandardAssignments Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/StandardAssignments/
     * GetStandardAssignment.json
     */
    /**
     * Sample code: Retrieve a standard assignment.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void retrieveAStandardAssignment(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.standardAssignments().getWithResponse("providers/Microsoft.Management/managementGroups/contoso",
            "1f3afdf9-d0c9-4c3d-847f-89da613e70a8", com.azure.core.util.Context.NONE);
    }
}

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": "/providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards/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

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

Name	Type	Description
assessmentKey	string	Unieke sleutel voor een beveiligingsevaluatieobject

AssignedStandardItem

De eigenschappen van een standaardtoewijzingsobjectverwijzing beschrijven

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

attestationComplianceState

Attest-categorie van deze toewijzing

Name	Type	Description
compliant	string
nonCompliant	string
unknown	string

AttestationData

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	Nalevingsdatum attestation
complianceState	attestationComplianceState	Attest-categorie van deze toewijzing
evidence	AttestationEvidence[]	Matrix van koppelingen naar attestation-bewijs

AttestationEvidence

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

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

Name	Type	Description
Attest	string
Audit	string
Exempt	string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

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

ErrorDetail

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

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

exemptionCategory

Uitzonderingscategorie van deze toewijzing

Name	Type	Description
mitigated	string
waiver	string

ExemptionData

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