Scope Access Review History Definition Instances - List

Service:

Authorization

API Version:

2021-12-01-preview

Mendapatkan instans definisi riwayat tinjauan akses menurut Id definisi

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
historyDefinitionId	path	True	string	Id definisi riwayat tinjauan akses.
scope	path	True	string	Cakupan sumber daya.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan HTTP.

Respons

Nama	Jenis	Deskripsi
200 OK	AccessReviewHistoryDefinitionInstanceListResult	Menjelaskan hasil operasi yang berhasil.
Other Status Codes	ErrorDefinition	Kesalahan tidak terduga

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

GetAccessReviewHistoryDefinitionInstances

Sample Request

HTTP

GET https://management.azure.com/subscriptions/129a304b-4aea-4b86-a9f7-ba7e2b23737a/providers/Microsoft.Authorization/accessReviewHistoryDefinitions/44724910-d7a5-4c29-b28f-db73e717165a/instances?api-version=2021-12-01-preview

Go

package armauthorization_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/authorization/armauthorization/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/310a0100f5b020c1900c527a6aa70d21992f078a/specification/authorization/resource-manager/Microsoft.Authorization/preview/2021-12-01-preview/examples/GetAccessReviewHistoryDefinitionInstances.json
func ExampleScopeAccessReviewHistoryDefinitionInstancesClient_NewListPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armauthorization.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewScopeAccessReviewHistoryDefinitionInstancesClient().NewListPager("subscriptions/129a304b-4aea-4b86-a9f7-ba7e2b23737a", "44724910-d7a5-4c29-b28f-db73e717165a", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.AccessReviewHistoryDefinitionInstanceListResult = armauthorization.AccessReviewHistoryDefinitionInstanceListResult{
		// 	Value: []*armauthorization.AccessReviewHistoryInstance{
		// 		{
		// 			Name: to.Ptr("44724910-d7a5-4c29-b28f-db73e717165a"),
		// 			Type: to.Ptr("Microsoft.Authorization/accessReviewHistoryInstance"),
		// 			ID: to.Ptr("44724910-d7a5-4c29-b28f-db73e717165a"),
		// 			Properties: &armauthorization.AccessReviewHistoryInstanceProperties{
		// 				DisplayName: to.Ptr("Hello world name"),
		// 				Expiration: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-01-22T00:28:33.690Z"); return t}()),
		// 				FulfilledDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-12-23T00:28:33.690Z"); return t}()),
		// 				ReviewHistoryPeriodEndDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-12-01T08:00:00.000Z"); return t}()),
		// 				ReviewHistoryPeriodStartDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-10-01T07:00:00.000Z"); return t}()),
		// 				RunDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-12-23T00:27:33.690Z"); return t}()),
		// 				Status: to.Ptr(armauthorization.AccessReviewHistoryDefinitionStatusRequested),
		// 			},
		// 	}},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { AuthorizationManagementClient } = require("@azure/arm-authorization");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Get access review history definition instances by definition Id
 *
 * @summary Get access review history definition instances by definition Id
 * x-ms-original-file: specification/authorization/resource-manager/Microsoft.Authorization/preview/2021-12-01-preview/examples/GetAccessReviewHistoryDefinitionInstances.json
 */
async function getAccessReviewHistoryDefinitionInstances() {
  const scope = "subscriptions/129a304b-4aea-4b86-a9f7-ba7e2b23737a";
  const historyDefinitionId = "44724910-d7a5-4c29-b28f-db73e717165a";
  const credential = new DefaultAzureCredential();
  const client = new AuthorizationManagementClient(credential);
  const resArray = new Array();
  for await (let item of client.scopeAccessReviewHistoryDefinitionInstances.list(
    scope,
    historyDefinitionId
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "44724910-d7a5-4c29-b28f-db73e717165a",
      "name": "44724910-d7a5-4c29-b28f-db73e717165a",
      "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",
        "expiration": "2022-01-22T00:28:33.6905189+00:00"
      }
    }
  ],
  "nextLink": null
}

Definisi

Nama	Deskripsi
AccessReviewHistoryDefinitionInstanceListResult	Daftar Instans Riwayat Tinjauan Akses.
AccessReviewHistoryDefinitionStatus	Bidang baca-saja ini menentukan dari data riwayat tinjauan yang diminta. Ini diminta, sedang berlangsung, selesai, atau kesalahan.
AccessReviewHistoryInstance	Instans Definisi Riwayat Tinjauan Akses.
ErrorDefinition	Kesalahan
ErrorDefinitionProperties	Kesalahan

AccessReviewHistoryDefinitionInstanceListResult

Daftar Instans Riwayat Tinjauan Akses.

Nama	Jenis	Deskripsi
nextLink	string	URL yang digunakan untuk mendapatkan serangkaian hasil berikutnya.
value	AccessReviewHistoryInstance[]	Daftar Instans Definisi Riwayat Tinjauan Akses.

AccessReviewHistoryDefinitionStatus

Bidang baca-saja ini menentukan dari data riwayat tinjauan yang diminta. Ini diminta, sedang berlangsung, selesai, atau kesalahan.

Nama	Jenis	Deskripsi
Done	string
Error	string
InProgress	string
Requested	string

AccessReviewHistoryInstance

Instans Definisi Riwayat Tinjauan Akses.

Nama	Jenis	Deskripsi
id	string	Id instans definisi riwayat tinjauan akses.
name	string	Id unik instans definisi riwayat tinjauan akses.
properties.displayName	string	Nama tampilan untuk definisi riwayat induk.
properties.downloadUri	string	Uri yang dapat digunakan untuk mengambil data riwayat ulasan. Untuk menghasilkan Uri ini, generateDownloadUri() harus dipanggil untuk accessReviewHistoryDefinitionInstance tertentu. Tautan kedaluwarsa setelah periode 24 jam. Penelepon dapat melihat waktu tanggal kedaluwarsa dengan melihat parameter 'se' di uri yang dihasilkan.
properties.expiration	string	Waktu tanggal saat laporan data riwayat kedaluwarsa dan data terkait dihapus.
properties.fulfilledDateTime	string	Waktu tanggal saat laporan data riwayat dijadwalkan untuk dibuat.
properties.reviewHistoryPeriodEndDateTime	string	Waktu tanggal yang digunakan saat memilih tinjau data, semua tinjauan yang disertakan dalam data berakhir pada atau sebelum tanggal ini. Untuk digunakan hanya dengan laporan satu kali/tidak berulang.
properties.reviewHistoryPeriodStartDateTime	string	Waktu tanggal yang digunakan saat memilih tinjau data, semua tinjauan yang disertakan dalam data dimulai pada atau setelah tanggal ini. Untuk digunakan hanya dengan laporan satu kali/tidak berulang.
properties.runDateTime	string	Waktu tanggal saat laporan data riwayat dijadwalkan untuk dibuat.
properties.status	AccessReviewHistoryDefinitionStatus	Status data instans riwayat tinjauan yang diminta. Ini diminta, sedang berlangsung, selesai, atau kesalahan. Transisi status adalah sebagai berikut - Diminta -> InProgress -> Selesai -> Kedaluwarsa
type	string	Jenis sumber daya.

ErrorDefinition

Kesalahan

Nama	Jenis	Deskripsi
error	ErrorDefinitionProperties	Kesalahan Kesalahan status gateway daftar.

ErrorDefinitionProperties

Kesalahan

Nama	Jenis	Deskripsi
code	string	Kode kesalahan gateway daftar.
message	string	Deskripsi kesalahan.