Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Definicja zasobu Bicepsa
Typ zasobu policySetDefinitions można wdrożyć przy użyciu operacji docelowych:
- grupy zarządzania — zobacz polecenia wdrażania grupy zarządzania * subskrypcji — zobacz polecenia wdrażania subskrypcji
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Przykłady użycia
Próbki Bicepsa
Podstawowy przykład wdrażania definicji zestawu zasad.
targetScope = 'subscription'
param resourceName string = 'acctest0001'
param location string = 'westus'
resource policyDefinition 'Microsoft.Authorization/policyDefinitions@2021-06-01' = {
name: resourceName
properties: {
description: ''
displayName: 'my-policy-definition'
mode: 'All'
parameters: {
allowedLocations: {
metadata: {
description: 'The list of allowed locations for resources.'
displayName: 'Allowed locations'
strongType: 'location'
}
type: 'Array'
}
}
policyRule: {
if: {
not: {
field: 'location'
in: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
}
}
then: {
effect: 'audit'
}
}
policyType: 'Custom'
}
}
resource policySetDefinition 'Microsoft.Authorization/policySetDefinitions@2025-01-01' = {
name: 'acctestpolset-${resourceName}'
properties: {
description: ''
displayName: 'acctestpolset-${resourceName}'
parameters: {
allowedLocations: {
metadata: {
description: 'The list of allowed locations for resources.'
displayName: 'Allowed locations'
strongType: 'location'
}
type: 'Array'
}
}
policyDefinitions: [
{
groupNames: []
parameters: {
listOfAllowedLocations: {
value: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
}
}
policyDefinitionId: policyDefinition.id
policyDefinitionReferenceId: ''
}
]
policyType: 'Custom'
}
}
Format zasobu
Aby stworzyć zasób Microsoft.Authorization/policySetDefinitions, dodaj do szablonu następujące Bicep.
resource symbolicname 'Microsoft.Authorization/policySetDefinitions@2017-06-01-preview' = {
name: 'string'
properties: {
description: 'string'
displayName: 'string'
metadata: any(...)
parameters: any(...)
policyDefinitions: [
{
parameters: any(...)
policyDefinitionId: 'string'
}
]
policyType: 'string'
}
}
Wartości właściwości
Microsoft.Authorization/policySetDefinitions
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości definicji zasad. | PolicySetDefinitionProperties |
PolicyDefinitionReference
| Nazwa | Opis | Wartość |
|---|---|---|
| Parametry | Wymagane, jeśli parametr jest używany w regule zasad. | jakikolwiek |
| policyDefinitionId | Identyfikator definicji zasad lub definicji zestawu zasad. | ciąg |
PolicySetDefinitionProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| opis | Opis definicji zestawu zasad. | ciąg |
| nazwa wyświetlana | Nazwa wyświetlana definicji zestawu zasad. | ciąg |
| metadane | Metadane definicji zestawu zasad. | jakikolwiek |
| Parametry | Parametry definicji zestawu zasad, które mogą być używane w odwołaniach definicji zasad. | jakikolwiek |
| definicje zasad | Tablica odwołań definicji zasad. | PolicyDefinitionReference[] (wymagane) |
| policyType | Typ definicji zasad. Możliwe wartości to NotSpecified, BuiltIn i Custom. | "BuiltIn" "Niestandardowy" "NotSpecified" |
Definicja zasobu szablonu usługi ARM
Typ zasobu policySetDefinitions można wdrożyć przy użyciu operacji docelowych:
- Grupy zarządzania – zobacz polecenia* wdrożenia grup zarządzaniaSubskrypcja – zobacz polecenia wdrożenia subskrypcji Aby uzyskać listę zmienionych właściwości w każdej wersji API, zobacz dziennik zmian.
Przykłady użycia
Format zasobu
Aby utworzyć zasób Microsoft.Authorization/policySetDefinitions, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.Authorization/policySetDefinitions",
"apiVersion": "2017-06-01-preview",
"name": "string",
"properties": {
"description": "string",
"displayName": "string",
"metadata": {},
"parameters": {},
"policyDefinitions": [
{
"parameters": {},
"policyDefinitionId": "string"
}
],
"policyType": "string"
}
}
Wartości właściwości
Microsoft.Authorization/policySetDefinitions
| Nazwa | Opis | Wartość |
|---|---|---|
| apiVersion | Wersja interfejsu API | "2017-06-01-preview" |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości definicji zasad. | PolicySetDefinitionProperties |
| typ | Typ zasobu | "Microsoft.Authorization/policySetDefinitions" |
PolicyDefinitionReference
| Nazwa | Opis | Wartość |
|---|---|---|
| Parametry | Wymagane, jeśli parametr jest używany w regule zasad. | jakikolwiek |
| policyDefinitionId | Identyfikator definicji zasad lub definicji zestawu zasad. | ciąg |
PolicySetDefinitionProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| opis | Opis definicji zestawu zasad. | ciąg |
| nazwa wyświetlana | Nazwa wyświetlana definicji zestawu zasad. | ciąg |
| metadane | Metadane definicji zestawu zasad. | jakikolwiek |
| Parametry | Parametry definicji zestawu zasad, które mogą być używane w odwołaniach definicji zasad. | jakikolwiek |
| definicje zasad | Tablica odwołań definicji zasad. | PolicyDefinitionReference[] (wymagane) |
| policyType | Typ definicji zasad. Możliwe wartości to NotSpecified, BuiltIn i Custom. | "BuiltIn" "Niestandardowy" "NotSpecified" |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu policySetDefinitions można wdrożyć przy użyciu operacji docelowych:
- Grupy zarządzające* Subskrypcja Listę zmienionych właściwości w każdej wersji API można znaleźć w dzienniku zmian.
Przykłady użycia
Przykłady programu Terraform
Podstawowy przykład wdrażania definicji zestawu zasad.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westus"
}
data "azapi_client_config" "current" {}
resource "azapi_resource" "policyDefinition" {
type = "Microsoft.Authorization/policyDefinitions@2021-06-01"
parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
name = var.resource_name
body = {
properties = {
description = ""
displayName = "my-policy-definition"
mode = "All"
parameters = {
allowedLocations = {
metadata = {
description = "The list of allowed locations for resources."
displayName = "Allowed locations"
strongType = "location"
}
type = "Array"
}
}
policyRule = {
if = {
not = {
field = "location"
in = "[parameters('allowedLocations')]"
}
}
then = {
effect = "audit"
}
}
policyType = "Custom"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "policySetDefinition" {
type = "Microsoft.Authorization/policySetDefinitions@2025-01-01"
parent_id = "/subscriptions/${data.azapi_client_config.current.subscription_id}"
name = "acctestpolset-${var.resource_name}"
body = {
properties = {
description = ""
displayName = "acctestpolset-${var.resource_name}"
parameters = {
allowedLocations = {
metadata = {
description = "The list of allowed locations for resources."
displayName = "Allowed locations"
strongType = "location"
}
type = "Array"
}
}
policyDefinitions = [{
groupNames = []
parameters = {
listOfAllowedLocations = {
value = "[parameters('allowedLocations')]"
}
}
policyDefinitionId = azapi_resource.policyDefinition.id
policyDefinitionReferenceId = ""
}]
policyType = "Custom"
}
}
}
Format zasobu
Aby utworzyć zasób Microsoft.Authorization/policySetDefinitions, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Authorization/policySetDefinitions@2017-06-01-preview"
name = "string"
parent_id = "string"
body = {
properties = {
description = "string"
displayName = "string"
metadata = ?
parameters = ?
policyDefinitions = [
{
parameters = ?
policyDefinitionId = "string"
}
]
policyType = "string"
}
}
}
Wartości właściwości
Microsoft.Authorization/policySetDefinitions
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości definicji zasad. | PolicySetDefinitionProperties |
| typ | Typ zasobu | "Microsoft.Authorization/policySetDefinitions@2017-06-01-preview" |
PolicyDefinitionReference
| Nazwa | Opis | Wartość |
|---|---|---|
| Parametry | Wymagane, jeśli parametr jest używany w regule zasad. | jakikolwiek |
| policyDefinitionId | Identyfikator definicji zasad lub definicji zestawu zasad. | ciąg |
PolicySetDefinitionProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| opis | Opis definicji zestawu zasad. | ciąg |
| nazwa wyświetlana | Nazwa wyświetlana definicji zestawu zasad. | ciąg |
| metadane | Metadane definicji zestawu zasad. | jakikolwiek |
| Parametry | Parametry definicji zestawu zasad, które mogą być używane w odwołaniach definicji zasad. | jakikolwiek |
| definicje zasad | Tablica odwołań definicji zasad. | PolicyDefinitionReference[] (wymagane) |
| policyType | Typ definicji zasad. Możliwe wartości to NotSpecified, BuiltIn i Custom. | "BuiltIn" "Niestandardowy" "NotSpecified" |