Policy Set Definition Versions - Create Or Update

Hizmet:: Policy

API Sürümü:: 2025-11-01

Bu işlem, verilen abonelikte verilen isim ve sürümle bir politika seti tanım sürümü oluşturur veya günceller.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
policyDefinitionVersion	path	True	string pattern: ^\d+\.\d+\.\d+$	İlke kümesi tanım sürümü. Format x.y.z'dir; burada x ana sürüm numarası, y küçük sürüm numarası ve z yama numarasıdır
policySetDefinitionName	path	True	string pattern: ^[^<>%&:\?.+/][^<>*%&:\?.+/ ]+$	İlke kümesi tanımının adı.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
properties.policyDefinitions	True	PolicyDefinitionReference[]	İlke tanımı başvuru dizisi.
properties.description		string	İlke kümesi tanım açıklaması.
properties.displayName		string	İlke kümesi tanımının görünen adı.
properties.metadata			İlke kümesi tanım meta verileri. Meta veriler açık uçlu bir nesnedir ve genellikle anahtar değer çiftleri koleksiyonudur.
properties.parameters		<string, ParameterDefinitionsValue>	İlke tanımı başvurularında kullanılabilecek ilke kümesi tanım parametreleri.
properties.policyDefinitionGroups		PolicyDefinitionGroup[]	İlke tanımı gruplarını açıklayan meta veriler, ilke kümesi tanımı içinde başvurur.
properties.policyType		PolicyType	İlke tanımının türü. Olası değerler NotSpecified, BuiltIn, Custom ve Static değerleridir.
properties.version		string	İlke, tanım sürümünü #.#.# biçiminde ayarlar.

Yanıtlar

Name	Tür	Description
200 OK	PolicySetDefinitionVersion	Kaynak 'PolicySetDefinitionVersion' güncelleme işlemi başarılı oldu
201 Created	PolicySetDefinitionVersion	Kaynak 'PolicySetDefinitionVersion' oluşturma işlemi başarılı oldu
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Create or update a policy set definition version

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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"
  }
}

Durum kodu:: 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"
  }
}

Tanımlar

Name	Description
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ParameterDefinitionsValue	Poliçeye sağlanabilecek bir parametrenin tanımı.
ParameterDefinitionsValueMetadata	parametresi için genel meta veriler.
ParameterType	Parametresinin veri türü.
ParameterValuesValue	Bir parametrenin değeri.
PolicyDefinitionGroup	Politika tanım grubu.
PolicyDefinitionReference	Politika tanımı referansı.
PolicySetDefinitionVersion	İlke kümesi tanım sürümü.
PolicyType	İlke tanımının türü. Olası değerler NotSpecified, BuiltIn, Custom ve Static değerleridir.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ParameterDefinitionsValue

Nesne

Poliçeye sağlanabilecek bir parametrenin tanımı.

Name	Tür	Description
allowedValues	AllowedValues[]	parametresi için izin verilen değerler.
defaultValue		Değer sağlanmazsa parametresi için varsayılan değer.
metadata	ParameterDefinitionsValueMetadata	parametresi için genel meta veriler.
schema		Kendi kendine tanımlanmış bir JSON şeması kullanarak atama sırasında parametre girişlerinin doğrulanması sağlar. Bu özellik yalnızca nesne tipi parametreler için desteklenir ve Json.NET Schema 2019-09 uygulamasını takip eder. adresinde şemaları https://json-schema.org/ kullanma hakkında daha fazla bilgi edinebilir ve adresinden taslak şemaları https://www.jsonschemavalidator.net/test edebilirsiniz.
type	ParameterType	Parametresinin veri türü.

ParameterDefinitionsValueMetadata

Nesne

parametresi için genel meta veriler.

Name	Tür	Description
assignPermissions	boolean	Politika ataması sırasında Azure portalının bu parametrenin kaynak kimliği veya kaynak kapsamı değeri üzerinde rol atamaları oluşturmasını sağlamak için doğru olarak ayarlanın. Bu özellik, atama kapsamının dışında izinler atamak istemeniz durumunda kullanışlıdır.
description	string	Parametresinin açıklaması.
displayName	string	Parametresinin görünen adı.
strongType	string	portal aracılığıyla ilke tanımı atanırken kullanılır. Kullanıcının seçileceği değerlerin bağlam bilgisi olan bir listesi sağlar.

ParameterType

Numaralandırma

Parametresinin veri türü.

Değer	Description
String	Dizi parametre türü.
Array	Dizi parametre türü.
Object	Nesne parametre türü.
Boolean	Boolean parametre türü.
Integer	Tamsayı parametre türü.
Float	Float parametre türü.
DateTime	Tarih-saat parametre türü.

ParameterValuesValue

Nesne

Bir parametrenin değeri.

Name	Tür	Description
value		parametresinin değeri.

PolicyDefinitionGroup

Nesne

Politika tanım grubu.

Name	Tür	Description
additionalMetadataId	string	Grup hakkında ek meta veriler içeren bir kaynağın kaynak kimliği.
category	string	Grubun kategorisi.
description	string	Grubun açıklaması.
displayName	string	Grubun görünen adı.
name	string	Grubun adı.

PolicyDefinitionReference

Nesne

Politika tanımı referansı.

Name	Tür	Description
definitionVersion	string	Kullanılacak ilke tanımının sürümü.
effectiveDefinitionVersion	string	Kullanılan politika tanımının etkili versiyonu. Bu sadece $expand sorgu parametresi üzerinden istendiğinde geçerlidir.
groupNames	string[]	Bu ilke tanımı başvurusunun ait olduğu grupların adı.
latestDefinitionVersion	string	Politika tanımının en güncel versiyonu mevcuttur. Bu sadece $expand sorgu parametresi üzerinden istendiğinde geçerlidir.
parameters	<string, ParameterValuesValue>	Başvuruda bulunan ilke kuralı için parametre değerleri. Anahtarlar parametre adlarıdır.
policyDefinitionId	string	İlke tanımının veya ilke kümesi tanımının kimliği.
policyDefinitionReferenceId	string	Bu ilke tanımı başvurusu için benzersiz bir kimlik (ilke kümesi tanımı içinde).