Policy Set Definition Versions - Create Or Update

Layanan:: Policy

Versi API:: 2025-11-01

Operasi ini membuat atau memperbarui versi definisi kumpulan kebijakan dalam langganan yang diberikan dengan nama dan versi yang diberikan.

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions/{policyDefinitionVersion}?api-version=2025-11-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
policyDefinitionVersion	path	True	string pattern: ^\d+\.\d+\.\d+$	Versi definisi kumpulan kebijakan. Formatnya adalah x.y.z di mana x adalah nomor versi utama, y adalah nomor versi minor, dan z adalah nomor patch
policySetDefinitionName	path	True	string pattern: ^[^<>%&:\?.+/][^<>*%&:\?.+/ ]+$	Nama definisi kumpulan kebijakan.
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.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
properties.policyDefinitions	True	PolicyDefinitionReference[]	Array referensi definisi kebijakan.
properties.description		string	Deskripsi definisi kumpulan kebijakan.
properties.displayName		string	Nama tampilan definisi kumpulan kebijakan.
properties.metadata			Metadata definisi kumpulan kebijakan. Metadata adalah objek terbuka dan biasanya merupakan kumpulan pasangan nilai kunci.
properties.parameters		<string, ParameterDefinitionsValue>	Parameter definisi kumpulan kebijakan yang dapat digunakan dalam referensi definisi kebijakan.
properties.policyDefinitionGroups		PolicyDefinitionGroup[]	Metadata yang menjelaskan grup referensi definisi kebijakan dalam definisi yang ditetapkan kebijakan.
properties.policyType		PolicyType	Jenis definisi kebijakan. Nilai yang mungkin adalah NotSpecified, BuiltIn, Custom, dan Static.
properties.version		string	Versi definisi set kebijakan dalam format #.#.#. .

Respons

Nama	Jenis	Deskripsi
200 OK	PolicySetDefinitionVersion	Operasi pembaruan 'PolicySetDefinitionVersion' sumber daya berhasil
201 Created	PolicySetDefinitionVersion	Resource 'PolicySetDefinitionVersion' membuat operasi berhasil
Other Status Codes	ErrorResponse	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

Create or update a policy set definition version

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policySetDefinitions/CostManagement/versions/1.2.1?api-version=2025-11-01

{
  "properties": {
    "description": "Policies to enforce low cost storage SKUs",
    "displayName": "Cost Management",
    "metadata": {
      "category": "Cost Management"
    },
    "parameters": {
      "namePrefix": {
        "type": "String",
        "defaultValue": "myPrefix",
        "metadata": {
          "displayName": "Prefix to enforce on resource names"
        }
      }
    },
    "policyDefinitions": [
      {
        "parameters": {
          "listOfAllowedSKUs": {
            "value": [
              "Standard_GRS",
              "Standard_LRS"
            ]
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
        "policyDefinitionReferenceId": "Limit_Skus"
      },
      {
        "parameters": {
          "prefix": {
            "value": "[parameters('namePrefix')]"
          },
          "suffix": {
            "value": "-LC"
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
        "policyDefinitionReferenceId": "Resource_Naming"
      }
    ],
    "version": "1.2.1"
  }
}

Respon sampel

Kode status:: 200

{
  "name": "1.2.1",
  "type": "Microsoft.Authorization/policySetDefinitions/versions",
  "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policySetDefinitions/CostManagement/versions/1.2.1",
  "properties": {
    "description": "Policies to enforce low cost storage SKUs",
    "displayName": "Cost Management",
    "metadata": {
      "category": "Cost Management"
    },
    "parameters": {
      "namePrefix": {
        "type": "String",
        "defaultValue": "myPrefix",
        "metadata": {
          "displayName": "Prefix to enforce on resource names"
        }
      }
    },
    "policyDefinitions": [
      {
        "definitionVersion": "1.*.*",
        "parameters": {
          "listOfAllowedSKUs": {
            "value": [
              "Standard_GRS",
              "Standard_LRS"
            ]
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
        "policyDefinitionReferenceId": "Limit_Skus"
      },
      {
        "definitionVersion": "1.*.*",
        "parameters": {
          "prefix": {
            "value": "[parameters('namePrefix')]"
          },
          "suffix": {
            "value": "-LC"
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
        "policyDefinitionReferenceId": "Resource_Naming"
      }
    ],
    "version": "1.2.1"
  }
}

Kode status:: 201

{
  "name": "1.2.1",
  "type": "Microsoft.Authorization/policySetDefinitions/versions",
  "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policySetDefinitions/CostManagement/versions/1.2.1",
  "properties": {
    "description": "Policies to enforce low cost storage SKUs",
    "displayName": "Cost Management",
    "metadata": {
      "category": "Cost Management"
    },
    "parameters": {
      "namePrefix": {
        "type": "String",
        "defaultValue": "myPrefix",
        "metadata": {
          "displayName": "Prefix to enforce on resource names"
        }
      }
    },
    "policyDefinitions": [
      {
        "definitionVersion": "1.*.*",
        "parameters": {
          "listOfAllowedSKUs": {
            "value": [
              "Standard_GRS",
              "Standard_LRS"
            ]
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
        "policyDefinitionReferenceId": "Limit_Skus"
      },
      {
        "definitionVersion": "1.*.*",
        "parameters": {
          "prefix": {
            "value": "[parameters('namePrefix')]"
          },
          "suffix": {
            "value": "-LC"
          }
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
        "policyDefinitionReferenceId": "Resource_Naming"
      }
    ],
    "version": "1.2.1"
  }
}

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
ParameterDefinitionsValue	Definisi parameter yang dapat diberikan ke kebijakan.
ParameterDefinitionsValueMetadata	Metadata umum untuk parameter .
ParameterType	Tipe data dari parameter.
ParameterValuesValue	Nilai parameter.
PolicyDefinitionGroup	Grup definisi kebijakan.
PolicyDefinitionReference	Referensi definisi kebijakan.
PolicySetDefinitionVersion	Versi definisi kumpulan kebijakan.
PolicyType	Jenis definisi kebijakan. Nilai yang mungkin adalah NotSpecified, BuiltIn, Custom, dan Static.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

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

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ParameterDefinitionsValue

Objek

Definisi parameter yang dapat diberikan ke kebijakan.

Nama	Jenis	Deskripsi
allowedValues	AllowedValues[]	Nilai yang diizinkan untuk parameter .
defaultValue		Nilai default untuk parameter jika tidak ada nilai yang disediakan.
metadata	ParameterDefinitionsValueMetadata	Metadata umum untuk parameter .
schema		Menyediakan validasi input parameter selama penugasan menggunakan skema JSON yang ditentukan sendiri. Properti ini hanya didukung untuk parameter jenis objek dan mengikuti implementasi Skema Json.NET 2019-09. Anda dapat mempelajari lebih lanjut tentang menggunakan skema di https://json-schema.org/ dan menguji draf skema di https://www.jsonschemavalidator.net/.
type	ParameterType	Tipe data dari parameter.

ParameterDefinitionsValueMetadata

Objek

Metadata umum untuk parameter .

Nama	Jenis	Deskripsi
assignPermissions	boolean	Atur ke true agar portal Azure membuat penetapan peran pada ID sumber daya atau nilai cakupan sumber daya parameter ini selama penetapan kebijakan. Properti ini berguna jika Anda ingin menetapkan izin di luar cakupan penugasan.
description	string	Deskripsi parameter.
displayName	string	Nama tampilan untuk parameter .
strongType	string	Digunakan saat menetapkan definisi kebijakan melalui portal. Menyediakan daftar nilai sadar konteks untuk dipilih pengguna.

ParameterType

Enumerasi

Tipe data dari parameter.

Nilai	Deskripsi
String	Jenis parameter string.
Array	Jenis parameter array.
Object	Jenis parameter objek.
Boolean	Jenis parameter boolean.
Integer	Jenis parameter bilangan bulat.
Float	Jenis parameter float.
DateTime	Jenis parameter tanggal-waktu.

ParameterValuesValue

Objek

Nilai parameter.

Nama	Jenis	Deskripsi
value		Nilai parameter .

PolicyDefinitionGroup

Objek

Grup definisi kebijakan.

Nama	Jenis	Deskripsi
additionalMetadataId	string	ID sumber daya sumber daya yang berisi metadata tambahan tentang grup.
category	string	Kategori grup.
description	string	Deskripsi grup.
displayName	string	Nama tampilan grup.
name	string	Nama grup.

PolicyDefinitionReference

Objek

Referensi definisi kebijakan.

Nama	Jenis	Deskripsi
definitionVersion	string	Versi definisi kebijakan yang akan digunakan.
effectiveDefinitionVersion	string	Versi efektif dari definisi kebijakan yang digunakan. Ini hanya ada jika diminta melalui parameter kueri $expand.
groupNames	string[]	Nama grup tempat referensi definisi kebijakan ini berada.
latestDefinitionVersion	string	Versi terbaru dari definisi kebijakan tersedia. Ini hanya ada jika diminta melalui parameter kueri $expand.
parameters	<string, ParameterValuesValue>	Nilai parameter untuk aturan kebijakan yang dirujuk. Kuncinya adalah nama parameter.
policyDefinitionId	string	ID definisi kebijakan atau definisi yang ditetapkan kebijakan.
policyDefinitionReferenceId	string	Id unik (dalam definisi kumpulan kebijakan) untuk referensi definisi kebijakan ini.