Admin Rule Collections - List

Layanan:: Network Manager

Versi API:: 2025-05-01

Mencantumkan semua kumpulan aturan dalam konfigurasi admin keamanan, dalam format paginasi.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}/ruleCollections?api-version=2025-05-01

Dengan parameter opsional:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}/ruleCollections?api-version=2025-05-01&$top={$top}&$skipToken={$skipToken}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
configurationName	path	True	string	Nama Konfigurasi Keamanan manajer jaringan.
networkManagerName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	Nama manajer jaringan.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
$skipToken	query		string	SkipToken hanya digunakan jika operasi sebelumnya mengembalikan hasil parsial. Jika respons sebelumnya berisi elemen nextLink, nilai elemen nextLink akan menyertakan parameter skipToken yang menentukan titik awal yang akan digunakan untuk panggilan berikutnya.
$top	query		integer (int32) minimum: 1 maximum: 20	Parameter kueri opsional yang menentukan jumlah maksimum rekaman yang akan dikembalikan oleh server.

Respons

Nama	Jenis	Deskripsi
200 OK	AdminRuleCollectionListResult	Operasi Azure berhasil diselesaikan.
Other Status Codes	CommonErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

List security admin rule collections

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig/ruleCollections?api-version=2025-05-01

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Lists all the rule collections in a security admin configuration, in a paginated format.
 *
 * @summary Lists all the rule collections in a security admin configuration, in a paginated format.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/NetworkManagerAdminRuleCollectionList.json
 */
async function listSecurityAdminRuleCollections() {
  const subscriptionId =
    process.env["NETWORK_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const networkManagerName = "testNetworkManager";
  const configurationName = "myTestSecurityConfig";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.adminRuleCollections.list(
    resourceGroupName,
    networkManagerName,
    configurationName,
  )) {
    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

Respon sampel

Kode status:: 200

{
  "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig/ruleCollections?api-version=2025-05-01&$skipToken=10",
  "value": [
    {
      "name": "testRuleCollection",
      "type": "Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig/ruleCollections/testRuleCollection",
      "properties": {
        "description": "A sample rule collection",
        "appliesToGroups": [
          {
            "networkGroupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/networkGroups/testGroup"
          }
        ],
        "provisioningState": "Succeeded",
        "resourceGuid": "00000000-0000-0000-0000-000000000000"
      },
      "systemData": {
        "createdAt": "2021-01-11T18:52:27Z",
        "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
        "createdByType": "User",
        "lastModifiedAt": "2021-01-11T18:52:27Z",
        "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
        "lastModifiedByType": "User"
      }
    }
  ]
}

Definisi

Nama	Deskripsi
AdminRuleCollection	Menentukan kumpulan aturan admin.
AdminRuleCollectionListResult	Respons operasi daftar AdminRuleCollection.
CommonErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
CommonErrorDetail	Detail kesalahan.
CommonErrorResponse	Tanggapan kesalahan
createdByType	Jenis identitas yang membuat sumber daya.
NetworkManagerSecurityGroupItem	Item grup keamanan manajer jaringan.
ProvisioningState	Status provisi sumber daya.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

AdminRuleCollection

Objek

Menentukan kumpulan aturan admin.

Nama	Jenis	Deskripsi
etag	string	String baca-saja unik yang berubah setiap kali sumber daya diperbarui.
id	string	ID Sumber Daya.
name	string	Nama sumber daya.
properties.appliesToGroups	NetworkManagerSecurityGroupItem[]	Grup untuk konfigurasi
properties.description	string	Deskripsi kumpulan aturan admin.
properties.provisioningState	ProvisioningState	Status provisi sumber daya.
properties.resourceGuid	string	Pengidentifikasi unik untuk sumber daya ini.
systemData	systemData	Metadata sistem yang terkait dengan sumber daya ini.
type	string	Jenis sumber daya.

AdminRuleCollectionListResult

Objek

Respons operasi daftar AdminRuleCollection.

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	AdminRuleCollection[]	Item AdminRuleCollection di halaman ini

CommonErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info		Info tambahan.
type	string	Jenis info tambahan.

CommonErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	CommonErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	CommonErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

CommonErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	CommonErrorDetail	Objek kesalahan.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

NetworkManagerSecurityGroupItem

Objek

Item grup keamanan manajer jaringan.

Nama	Jenis	Deskripsi
networkGroupId	string	Id grup manajer jaringan.

ProvisioningState

Enumerasi

Status provisi sumber daya.

Nilai	Deskripsi
Failed	Kegagalan
Succeeded	Berhasil
Canceled	Dibatalkan
Creating	Membuat
Updating	Memperbarui
Deleting	Menghapus

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

Bagikan melalui

Admin Rule Collections - List

Parameter URI

Respons

Keamanan

azure_auth

Cakupan

Contoh

List security admin rule collections

Permintaan sampel

Respon sampel

Definisi

AdminRuleCollection

AdminRuleCollectionListResult

CommonErrorAdditionalInfo

CommonErrorDetail

CommonErrorResponse

createdByType

NetworkManagerSecurityGroupItem

ProvisioningState

systemData