Delen via


Scope Access Review History Definition Instance - Generate Download Uri

Hiermee wordt een URI gegenereerd die kan worden gebruikt om gegevens over de beoordelingsgeschiedenis op te halen. Deze URI heeft een TTL van 1 dag en kan worden opgehaald door het accessReviewHistoryDefinition-object op te halen.

POST https://management.azure.com/{scope}/providers/Microsoft.Authorization/accessReviewHistoryDefinitions/{historyDefinitionId}/instances/{instanceId}/generateDownloadUri?api-version=2021-12-01-preview

URI-parameters

Name In Vereist Type Description
historyDefinitionId
path True

string

De id van de definitie van de toegangsbeoordelingsgeschiedenis.

instanceId
path True

string

De id van het definitie-exemplaar van de toegangsbeoordelingsgeschiedenis waarvoor een URI moet worden gegenereerd.

scope
path True

string

Het bereik van de resource.

api-version
query True

string

De API-versie die moet worden gebruikt met de HTTP-aanvraag.

Antwoorden

Name Type Description
200 OK

AccessReviewHistoryInstance

AccessReviewHistoryInstance

Other Status Codes

ErrorDefinition

Onverwachte fout

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

PostAccessReviewHistoryDefinitionInstance

Voorbeeldaanvraag

POST https://management.azure.com/subscriptions/129a304b-4aea-4b86-a9f7-ba7e2b23737a/providers/Microsoft.Authorization/accessReviewHistoryDefinitions/44724910-d7a5-4c29-b28f-db73e717165a/instances/9038f4f3-3d8d-43c3-8ede-669ea082c43b/generateDownloadUri?api-version=2021-12-01-preview

Voorbeeldrespons

{
  "id": "9038f4f3-3d8d-43c3-8ede-669ea082c43b",
  "name": "9038f4f3-3d8d-43c3-8ede-669ea082c43b",
  "type": "Microsoft.Authorization/accessReviewHistoryInstance",
  "properties": {
    "reviewHistoryPeriodStartDateTime": "2021-10-01T00:00:00-07:00",
    "reviewHistoryPeriodEndDateTime": "2021-12-01T00:00:00-08:00",
    "displayName": "Hello world name",
    "status": "Requested",
    "runDateTime": "2021-12-23T00:27:33.6905189+00:00",
    "fulfilledDateTime": "2021-12-23T00:28:33.6905189+00:00",
    "downloadUri": "https://dfermconsolreportusc.blob.core.windows.net/df-erm-reports/Hello world name-22be232e-a93d-42a3-8ac5-313cfd29a0eb.csv?sv=2015-04-05&ss=b&srt=o&sp=rl&st=2021-03-22T19:39:38.0000000Z&se=2021-03-23T19:41:38.0000000Z&spr=https&sig=84rlGCIgU4ToMn%2FFLncBXq95O8a8RsFlwQY1Knl%2Fo%2FI%3D",
    "expiration": "2022-01-22T00:28:33.6905189+00:00"
  }
}

Definities

Name Description
AccessReviewHistoryDefinitionStatus

In dit alleen-lezen veld wordt de van de aangevraagde beoordelingsgeschiedenisgegevens opgegeven. Dit is aangevraagd, wordt uitgevoerd, wordt uitgevoerd of is mislukt.

AccessReviewHistoryInstance

Definitie-exemplaar van toegangsbeoordelingsgeschiedenis.

ErrorDefinition

Fout

ErrorDefinitionProperties

Fout

AccessReviewHistoryDefinitionStatus

In dit alleen-lezen veld wordt de van de aangevraagde beoordelingsgeschiedenisgegevens opgegeven. Dit is aangevraagd, wordt uitgevoerd, wordt uitgevoerd of is mislukt.

Name Type Description
Done

string

Error

string

InProgress

string

Requested

string

AccessReviewHistoryInstance

Definitie-exemplaar van toegangsbeoordelingsgeschiedenis.

Name Type Description
id

string

De instantie-id van de definitie van de toegangsbeoordelingsgeschiedenis.

name

string

De unieke id van het exemplaar van de definitie van de toegangsbeoordelingsgeschiedenis.

properties.displayName

string

De weergavenaam voor de bovenliggende geschiedenisdefinitie.

properties.downloadUri

string

URI die kan worden gebruikt om gegevens over de beoordelingsgeschiedenis op te halen. Als u deze URI wilt genereren, moet generateDownloadUri() worden aangeroepen voor een specifieke accessReviewHistoryDefinitionInstance. De koppeling verloopt na een periode van 24 uur. Bellers kunnen de vervaldatum zien door te kijken naar de parameter 'se' in de gegenereerde URI.

properties.expiration

string

De datum waarop het geschiedenisgegevensrapport verloopt en de bijbehorende gegevens worden verwijderd.

properties.fulfilledDateTime

string

De datum waarop het geschiedenisgegevensrapport volgens de planning moet worden gegenereerd.

properties.reviewHistoryPeriodEndDateTime

string

Datum/tijd die wordt gebruikt bij het selecteren van beoordelingsgegevens. Alle beoordelingen die in de gegevens zijn opgenomen, eindigen op of vóór deze datum. Alleen voor gebruik met eenmalige/niet-terugkerende rapporten.

properties.reviewHistoryPeriodStartDateTime

string

Datum/tijd die wordt gebruikt bij het selecteren van beoordelingsgegevens, alle beoordelingen die in de gegevens zijn opgenomen, beginnen op of na deze datum. Alleen voor gebruik met eenmalige/niet-terugkerende rapporten.

properties.runDateTime

string

De datum waarop het geschiedenisgegevensrapport volgens de planning moet worden gegenereerd.

properties.status

AccessReviewHistoryDefinitionStatus

Status van de aangevraagde controlegeschiedenisexemplaargegevens. Dit is aangevraagd, wordt uitgevoerd, wordt uitgevoerd of is mislukt. De statusovergangen zijn als volgt : Aangevraagd -> InProgress -> Gereed -> Verlopen

type

string

Het resourcetype.

ErrorDefinition

Fout

Name Type Description
error

ErrorDefinitionProperties

Fout
Fout van de gatewaystatus van de lijst.

ErrorDefinitionProperties

Fout

Name Type Description
code

string

Foutcode van lijstgateway.

message

string

Beschrijving van de fout.