Sdílet prostřednictvím


Scope Access Review History Definition Instance - Generate Download Uri

Vygeneruje identifikátor URI, který lze použít k načtení dat historie revizí. Tento identifikátor URI má hodnotu TTL 1 den a lze ho načíst načtením objektu accessReviewHistoryDefinition.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
historyDefinitionId
path True

string

ID definice historie kontroly přístupu.

instanceId
path True

string

ID instance definice historie kontroly přístupu, pro kterou se vygeneruje identifikátor URI.

scope
path True

string

Rozsah prostředku.

api-version
query True

string

Verze rozhraní API, která se má použít s požadavkem HTTP.

Odpovědi

Name Typ Description
200 OK

AccessReviewHistoryInstance

AccessReviewHistoryInstance

Other Status Codes

ErrorDefinition

Neočekávaná chyba

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

PostAccessReviewHistoryDefinitionInstance

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
AccessReviewHistoryDefinitionStatus

Toto pole jen pro čtení určuje požadovaných dat historie kontrol. Toto je buď požadováno, probíhá, je dokončeno nebo došlo k chybě.

AccessReviewHistoryInstance

Instance definice historie kontroly přístupu

ErrorDefinition

Chyba

ErrorDefinitionProperties

Chyba

AccessReviewHistoryDefinitionStatus

Toto pole jen pro čtení určuje požadovaných dat historie kontrol. Toto je buď požadováno, probíhá, je dokončeno nebo došlo k chybě.

Name Typ Description
Done

string

Error

string

InProgress

string

Requested

string

AccessReviewHistoryInstance

Instance definice historie kontroly přístupu

Name Typ Description
id

string

ID instance definice historie přístupu

name

string

Jedinečné ID instance definice historie kontroly přístupu

properties.displayName

string

Zobrazovaný název definice nadřazené historie.

properties.downloadUri

string

Identifikátor URI, který lze použít k načtení dat historie kontrol. Chcete-li vygenerovat tento identifikátor URI, musí být volána funkce generateDownloadUri() pro konkrétní accessReviewHistoryDefinitionInstance. Platnost odkazu vyprší po 24hodinovém období. Volající uvidí datum vypršení platnosti podle parametru se ve vygenerovaném identifikátoru URI.

properties.expiration

string

Datum a čas, kdy vyprší platnost sestavy dat historie a přidružená data se odstraní.

properties.fulfilledDateTime

string

Datum a čas, kdy je naplánováno generování sestavy dat historie.

properties.reviewHistoryPeriodEndDateTime

string

Datum a čas použitý při výběru revizí dat. Všechny recenze zahrnuté v datech končí tímto datem nebo před tímto datem. Pro použití pouze s jednorázovými nebo neopakujícími se sestavami.

properties.reviewHistoryPeriodStartDateTime

string

Datum a čas použitý při výběru revizí dat. Všechny recenze zahrnuté v datech začínají tímto datem nebo po tomto datu. Pro použití pouze s jednorázovými nebo neopakujícími se sestavami.

properties.runDateTime

string

Datum a čas, kdy je naplánováno generování sestavy dat historie.

properties.status

AccessReviewHistoryDefinitionStatus

Stav požadovaných dat instance historie kontrol. Toto je buď požadováno, probíhá, je dokončeno nebo došlo k chybě. Přechody stavu jsou následující : Požadováno –> Probíhající –> Hotovo –> Vypršela platnost.

type

string

Typ prostředku.

ErrorDefinition

Chyba

Name Typ Description
error

ErrorDefinitionProperties

Chyba
Chyba stavu brány seznamu

ErrorDefinitionProperties

Chyba

Name Typ Description
code

string

Kód chyby brány seznamu.

message

string

Popis chyby