Partilhar via


Scope Access Review History Definition Instance - Generate Download Uri

Gera um uri que pode ser utilizado para obter dados do histórico de revisões. Este URI tem um TTL de 1 dia e pode ser obtido ao obter o objeto accessReviewHistoryDefinition.

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

Parâmetros do URI

Name Em Necessário Tipo Description
historyDefinitionId
path True

string

O ID da definição do histórico de revisão de acesso.

instanceId
path True

string

O ID da instância de definição do histórico de revisão de acesso para gerar um URI.

scope
path True

string

O âmbito do recurso.

api-version
query True

string

A versão da API a utilizar com o pedido HTTP.

Respostas

Name Tipo Description
200 OK

AccessReviewHistoryInstance

AccessReviewHistoryInstance

Other Status Codes

ErrorDefinition

Erro inesperado

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

PostAccessReviewHistoryDefinitionInstance

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
AccessReviewHistoryDefinitionStatus

Este campo só de leitura especifica os dados do histórico de revisões pedidos. Isto é pedido, em curso, concluído ou erro.

AccessReviewHistoryInstance

Instância de Definição do Histórico de Revisão de Acesso.

ErrorDefinition

Erro

ErrorDefinitionProperties

Erro

AccessReviewHistoryDefinitionStatus

Este campo só de leitura especifica os dados do histórico de revisões pedidos. Isto é pedido, em curso, concluído ou erro.

Name Tipo Description
Done

string

Error

string

InProgress

string

Requested

string

AccessReviewHistoryInstance

Instância de Definição do Histórico de Revisão de Acesso.

Name Tipo Description
id

string

O ID da instância da definição do histórico de revisão de acesso.

name

string

O ID exclusivo da instância de definição do histórico de revisão de acesso.

properties.displayName

string

O nome a apresentar para a definição do histórico principal.

properties.downloadUri

string

Uri que pode ser utilizado para obter dados do histórico de revisões. Para gerar este Uri, generateDownloadUri() tem de ser chamado para um acesso específicoReviewHistoryDefinitionInstance. A ligação expira após um período de 24 horas. Os autores da chamada podem ver a data de expiração ao observar o parâmetro "se" no uri gerado.

properties.expiration

string

Data em que o relatório de dados do histórico expira e os dados associados são eliminados.

properties.fulfilledDateTime

string

Data em que o relatório de dados do histórico está agendado para ser gerado.

properties.reviewHistoryPeriodEndDateTime

string

Data de hora utilizada ao selecionar rever dados, todas as revisões incluídas nos dados terminam em ou antes desta data. Para utilização apenas com relatórios únicos/não periódicos.

properties.reviewHistoryPeriodStartDateTime

string

Data de hora utilizada ao selecionar rever dados, todas as revisões incluídas nos dados começam em ou depois desta data. Para utilização apenas com relatórios únicos/não periódicos.

properties.runDateTime

string

Data em que o relatório de dados do histórico está agendado para ser gerado.

properties.status

AccessReviewHistoryDefinitionStatus

Estado dos dados da instância do histórico de revisão pedidos. Isto é pedido, em curso, concluído ou erro. As transições de estado são as seguintes – Pedido –> InProgress –> Concluído –> Expirado

type

string

O tipo de recurso.

ErrorDefinition

Erro

Name Tipo Description
error

ErrorDefinitionProperties

Erro
Erro do estado do gateway de lista.

ErrorDefinitionProperties

Erro

Name Tipo Description
code

string

Código de erro do gateway de lista.

message

string

Descrição do erro.