Compartilhar via


Scope Access Review History Definition Instance - Generate Download Uri

Gera um uri que pode ser usado para recuperar dados de histórico de revisão. Esse URI tem um TTL de 1 dia e pode ser recuperado buscando 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 de URI

Nome Em Obrigatório Tipo Description
historyDefinitionId
path True

string

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

instanceId
path True

string

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

scope
path True

string

O escopo do recurso.

api-version
query True

string

A versão da API a ser usada com a solicitação HTTP.

Respostas

Nome Tipo Description
200 OK

AccessReviewHistoryInstance

AccessReviewHistoryInstance

Other Status Codes

ErrorDefinition

Erro inesperado

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

PostAccessReviewHistoryDefinitionInstance

Solicitação de exemplo

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 de exemplo

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

Nome Description
AccessReviewHistoryDefinitionStatus

Este campo somente leitura especifica o dos dados de histórico de revisão solicitados. Isso é solicitado, em andamento, feito ou erro.

AccessReviewHistoryInstance

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

ErrorDefinition

Erro

ErrorDefinitionProperties

Erro

AccessReviewHistoryDefinitionStatus

Este campo somente leitura especifica o dos dados de histórico de revisão solicitados. Isso é solicitado, em andamento, feito ou erro.

Nome Tipo Description
Done

string

Error

string

InProgress

string

Requested

string

AccessReviewHistoryInstance

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

Nome Tipo Description
id

string

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

name

string

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

properties.displayName

string

O nome de exibição para a definição do histórico pai.

properties.downloadUri

string

Uri que pode ser usado para recuperar dados de histórico de revisão. Para gerar esse Uri, generateDownloadUri() deve ser chamado para um accessReviewHistoryDefinitionInstance específico. O link expira após um período de 24 horas. Os chamadores podem ver a hora da data de validade examinando o parâmetro 'se' no uri gerado.

properties.expiration

string

Data em que o relatório de dados de histórico expira e os dados associados são excluídos.

properties.fulfilledDateTime

string

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

properties.reviewHistoryPeriodEndDateTime

string

Data de data usada ao selecionar dados de revisão, todas as revisões incluídas nos dados terminam em ou antes dessa data. Para uso somente com relatórios únicos/não recorrentes.

properties.reviewHistoryPeriodStartDateTime

string

Data de data usada ao selecionar dados de revisão, todas as revisões incluídas nos dados começam em ou após essa data. Para uso somente com relatórios únicos/não recorrentes.

properties.runDateTime

string

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

properties.status

AccessReviewHistoryDefinitionStatus

Status dos dados da instância de histórico de revisão solicitados. Isso é solicitado, em andamento, feito ou erro. As transições de estado são as seguintes - Solicitadas -> InProgress -> Concluído -> Expirado

type

string

O tipo de recurso.

ErrorDefinition

Erro

Nome Tipo Description
error

ErrorDefinitionProperties

Erro
Erro do gateway de lista status.

ErrorDefinitionProperties

Erro

Nome Tipo Description
code

string

Código de erro do gateway de lista.

message

string

Descrição do erro.