Dela via


Scope Access Review History Definition Instance - Generate Download Uri

Genererar en URI som kan användas för att hämta granskningshistorikdata. Den här URI:n har en TTL på 1 dag och kan hämtas genom att hämta objektet accessReviewHistoryDefinition.

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

URI-parametrar

Name I Obligatorisk Typ Description
historyDefinitionId
path True

string

ID:t för definitionen för åtkomstgranskningshistorik.

instanceId
path True

string

ID:t för den definitionsinstans för åtkomstgranskningshistorik som ska generera en URI för.

scope
path True

string

Resursens omfång.

api-version
query True

string

DEN API-version som ska användas med HTTP-begäran.

Svar

Name Typ Description
200 OK

AccessReviewHistoryInstance

AccessReviewHistoryInstance

Other Status Codes

ErrorDefinition

Oväntat fel

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

PostAccessReviewHistoryDefinitionInstance

Exempelbegäran

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

Exempelsvar

{
  "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"
  }
}

Definitioner

Name Description
AccessReviewHistoryDefinitionStatus

Det här skrivskyddade fältet anger de begärda granskningshistorikdata. Detta begärs, pågår, görs eller fel.

AccessReviewHistoryInstance

Åtkomstgranskningshistorikdefinitionsinstans.

ErrorDefinition

Fel

ErrorDefinitionProperties

Fel

AccessReviewHistoryDefinitionStatus

Det här skrivskyddade fältet anger de begärda granskningshistorikdata. Detta begärs, pågår, görs eller fel.

Name Typ Description
Done

string

Error

string

InProgress

string

Requested

string

AccessReviewHistoryInstance

Åtkomstgranskningshistorikdefinitionsinstans.

Name Typ Description
id

string

ID:t för definitionsinstansen för åtkomstgranskningshistorik.

name

string

Unikt ID för åtkomstgranskningshistorikdefinitionsinstansen.

properties.displayName

string

Visningsnamnet för den överordnade historikdefinitionen.

properties.downloadUri

string

Uri som kan användas för att hämta granskningshistorikdata. För att generera den här URI:n måste generateDownloadUri() anropas för en specifik åtkomstReviewHistoryDefinitionInstance. Länken upphör att gälla efter en 24-timmarsperiod. Anropare kan se förfallodatumtiden genom att titta på parametern "se" i den genererade URI:n.

properties.expiration

string

Datum när historikdatarapporten upphör att gälla och associerade data tas bort.

properties.fulfilledDateTime

string

Datum då historikdatarapporten är schemalagd att genereras.

properties.reviewHistoryPeriodEndDateTime

string

Datumtid som används när du väljer granska data, alla granskningar som ingår i data slutar på eller före detta datum. Endast för användning med engångsrapporter/icke-återkommande rapporter.

properties.reviewHistoryPeriodStartDateTime

string

Datumtid som används när du väljer granska data, alla granskningar som ingår i data börjar på eller efter detta datum. Endast för användning med engångsrapporter/icke-återkommande rapporter.

properties.runDateTime

string

Datum då historikdatarapporten är schemalagd att genereras.

properties.status

AccessReviewHistoryDefinitionStatus

Status för begärda instansdata för granskningshistorik. Detta begärs, pågår, görs eller fel. Tillståndsövergångarna är följande – Begärd –> InProgress –> Klar –> Har upphört att gälla

type

string

Resurstypen.

ErrorDefinition

Fel

Name Typ Description
error

ErrorDefinitionProperties

Fel
Fel i listans gatewaystatus.

ErrorDefinitionProperties

Fel

Name Typ Description
code

string

Felkod för listgateway.

message

string

Beskrivning av felet.