Standard Assignments - Get

Referens

Tjänst:: Defender for Cloud

API-version:: 2024-08-01

Hämtar en standardtilldelning.
Den här åtgärden hämtar en enda standardtilldelning med namnet och det omfång som den skapades på.

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

URI-parametrar

Name I Obligatorisk Typ Description

Name	I	Obligatorisk	Typ	Description
resourceId	path	True	string	Resursens identifierare.
standardAssignmentName	path	True	string	Tilldelningsnyckeln för standardtilldelningar – unik nyckel för standardtilldelningen Reguljärt uttrycksmönster: `[{]?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$`
api-version	query	True	string	DEN API-version som ska användas för den här åtgärden.

resourceId

path

True

string

Resursens identifierare.

standardAssignmentName

path

True

string

Tilldelningsnyckeln för standardtilldelningar – unik nyckel för standardtilldelningen

Reguljärt uttrycksmönster: [{]?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$

api-version

query

True

string

DEN API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	StandardAssignment	Returnerar information om standardtilldelningen.
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

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

Exempelsvar

Statuskod:: 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"
    }
  }
}

Definitioner

Name	Description
AssignedAssessmentItem	Beskriva egenskaperna för en objektreferens för säkerhetsutvärdering (efter nyckel)
AssignedStandardItem	Beskriva egenskaperna för en referens för ett standardtilldelningsobjekt
attestationComplianceState	Attestkategori för den här tilldelningen
AttestationData	Ytterligare data om tilldelning som har attest-effekt
AttestationEvidence	Beskriva egenskaperna för en tilldelningsattestering
effect	Förväntad effekt av den här tilldelningen (granskning/undantag/intyg)
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
exemptionCategory	Undantagskategori för den här tilldelningen
ExemptionData	Ytterligare data om tilldelning som har undantagseffekt
StandardAssignment	Säkerhetstilldelning för en resursgrupp över ett visst omfång
StandardAssignmentMetadata	Metadata för standardtilldelning

AssignedAssessmentItem

Beskriva egenskaperna för en objektreferens för säkerhetsutvärdering (efter nyckel)

Name	Typ	Description
assessmentKey	string	Unik nyckel till ett objekt för säkerhetsutvärdering

AssignedStandardItem

Beskriva egenskaperna för en referens för ett standardtilldelningsobjekt

Name	Typ	Description
id	string	Fullständigt resourceId för Objektet Microsoft.Security/standard

attestationComplianceState

Attestkategori för den här tilldelningen

Name	Typ	Description
compliant	string
nonCompliant	string
unknown	string

AttestationData

Ytterligare data om tilldelning som har attest-effekt

Name	Typ	Description
assignedAssessment	AssignedAssessmentItem	Komponentobjekt med nyckel som tillämpas på den här standardtilldelningen över det angivna omfånget
complianceDate	string	Datum för attesteringsefterlevnad
complianceState	attestationComplianceState	Attestkategori för den här tilldelningen
evidence	AttestationEvidence[]	Matris med länkar till attesteringsbevis

AttestationEvidence

Beskriva egenskaperna för en tilldelningsattestering

Name	Typ	Description
description	string	Beskrivningen av bevisen
sourceUrl	string	Käll-URL:en för bevisen

effect

Förväntad effekt av den här tilldelningen (granskning/undantag/intyg)

Name	Typ	Description
Attest	string
Audit	string
Exempt	string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

exemptionCategory

Undantagskategori för den här tilldelningen

Name	Typ	Description
mitigated	string
waiver	string

ExemptionData

Ytterligare data om tilldelning som har undantagseffekt

Name	Typ	Description
assignedAssessment	AssignedAssessmentItem	Komponentobjekt med nyckel som tillämpas på den här standardtilldelningen över det angivna omfånget
exemptionCategory	exemptionCategory	Undantagskategori för den här tilldelningen