Policy States - List Query Results For Resource Group

Hizmet:: Policy

API Sürümü:: 2024-10-01

Kaynak grubu altındaki kaynaklar için ilke durumlarını sorgular.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults?api-version=2024-10-01

İsteğe bağlı parametrelerle:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults?api-version=2024-10-01&$top={$top}&$orderby={$orderby}&$select={$select}&$from={$from}&$to={$to}&$filter={$filter}&$apply={$apply}&$skiptoken={$skiptoken}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
policyStatesResource	path	True	PolicyStatesResource	PolicyStates kaynak türü altındaki sanal kaynak. Belirli bir zaman aralığında 'en son' en son ilke durumlarını, 'varsayılan' ise tüm ilke durumlarını temsil eder.
resourceGroupName	path	True	string	Kaynak grubu adı.
subscriptionId	path	True	string	Microsoft Azure subscription ID.
api-version	query	True	string	İstemci Api Sürümü.
$apply	query		string	Toplamalar için OData uygulama ifadesi.
$filter	query		string	OData filtre ifadesi.
$from	query		string (date-time)	Sorgulanma aralığının başlangıç zamanını belirten ISO 8601 biçimli zaman damgası. Belirtilmediğinde, hizmet kullanır ($to - 1 gün).
$orderby	query		string	OData gösterimini kullanarak ifade sıralama. "$orderby=PolicyAssignmentId, ResourceId asc" gibi isteğe bağlı "desc" (varsayılan) veya "asc" ile bir veya daha fazla virgülle ayrılmış sütun adı.
$select	query		string	OData gösterimini kullanarak ifadeyi seçin. Her kayıt üzerindeki sütunları yalnızca istenen sütunlarla sınırlar; örneğin, "$select=PolicyAssignmentId, ResourceId".
$skiptoken	query		string	Skiptoken yalnızca önceki bir yanıt nextLink öğesinin parçası olarak kısmi bir sonuç döndürdüyse sağlanır.
$to	query		string (date-time)	Sorgu için aralığın bitiş saatini belirten ISO 8601 biçimli zaman damgası. Belirtilmediğinde, hizmet istek süresini kullanır.
$top	query		integer (int32) minimum: 0	Döndürülecek en fazla kayıt sayısı.

Yanıtlar

Name	Tür	Description
200 OK	PolicyStatesQueryResults	Sorgu sonuçları.
Other Status Codes	QueryFailure	İşlemin neden başarısız olduğunu açıklayan 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

Query latest at resource group scope

Query latest at resource group scope with next link

Query latest at resource group scope

Örnek isteği

HTTP

POST https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyStates/latest/queryResults?api-version=2024-10-01

Örnek yanıt

Durum kodu:: 200

{
  "@odata.nextLink": null,
  "@odata.context": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest",
  "@odata.count": 2,
  "value": [
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest/$entity",
      "timestamp": "2019-10-09T18:42:42Z",
      "resourceId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/mysa1",
      "policyAssignmentId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyAssignments/3f3c4330183b4e218fe6fd29",
      "policyDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyDefinitions/24813039-7534-408a-9842-eb99f45721b1",
      "effectiveParameters": null,
      "isCompliant": false,
      "subscriptionId": "fffedd8f-ffff-fffd-fffd-fffed2f84852",
      "resourceType": "/Microsoft.Storage/storageAccounts",
      "resourceLocation": "eastus",
      "resourceGroup": "myResourceGroup",
      "resourceTags": "tbd",
      "policyAssignmentName": "3f3c4330183b4e218fe6fd29",
      "policyAssignmentOwner": "tbd",
      "policyAssignmentParameters": "{}",
      "policyAssignmentScope": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852",
      "policyDefinitionName": "24813039-7534-408a-9842-eb99f45721b1",
      "policyDefinitionAction": "audit",
      "policyDefinitionCategory": "tbd",
      "policySetDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policySetDefinitions/3e3807c1-65c9-49e0-a406-82d8ae3e338c",
      "policySetDefinitionName": "3e3807c1-65c9-49e0-a406-82d8ae3e338c",
      "policySetDefinitionOwner": null,
      "policySetDefinitionCategory": null,
      "policySetDefinitionParameters": null,
      "managementGroupIds": "mymg,fff988bf-fff1-ffff-fffb-fffcd011db47",
      "policyDefinitionReferenceId": null,
      "complianceState": "NonCompliant",
      "policyDefinitionGroupNames": [
        "myGroup"
      ],
      "policyDefinitionVersion": "1.0.0-preview",
      "policySetDefinitionVersion": "2.0.1",
      "policyAssignmentVersion": "1.0.0"
    },
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest/$entity",
      "timestamp": "2019-10-09T18:42:42Z",
      "resourceId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/mysa1",
      "policyAssignmentId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyAssignments/3f3c4330183b4e218fe6fd29",
      "policyDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyDefinitions/3e3807c1-65c9-49e0-a406-82d8ae3e3682",
      "effectiveParameters": null,
      "isCompliant": true,
      "subscriptionId": "fffedd8f-ffff-fffd-fffd-fffed2f84852",
      "resourceType": "/Microsoft.Storage/storageAccounts",
      "resourceLocation": "eastus",
      "resourceGroup": "myResourceGroup",
      "resourceTags": "tbd",
      "policyAssignmentName": "3f3c4330183b4e218fe6fd29",
      "policyAssignmentOwner": "tbd",
      "policyAssignmentParameters": "{}",
      "policyAssignmentScope": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852",
      "policyDefinitionName": "3e3807c1-65c9-49e0-a406-82d8ae3e3682",
      "policyDefinitionAction": "audit",
      "policyDefinitionCategory": "tbd",
      "policySetDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policySetDefinitions/3e3807c1-65c9-49e0-a406-82d8ae3e338c",
      "policySetDefinitionName": "3e3807c1-65c9-49e0-a406-82d8ae3e338c",
      "policySetDefinitionOwner": null,
      "policySetDefinitionCategory": null,
      "policySetDefinitionParameters": null,
      "managementGroupIds": "mymg,fff988bf-fff1-ffff-fffb-fffcd011db47",
      "policyDefinitionReferenceId": null,
      "complianceState": "Compliant",
      "policyDefinitionGroupNames": [
        "myGroup"
      ],
      "policyDefinitionVersion": "1.0.0-preview",
      "policySetDefinitionVersion": "2.0.1",
      "policyAssignmentVersion": "1.0.0"
    }
  ]
}

Query latest at resource group scope with next link

Örnek isteği

HTTP

POST https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyStates/latest/queryResults?api-version=2024-10-01&$skiptoken=WpmWfBSvPhkAK6QD

Örnek yanıt

Durum kodu:: 200

{
  "@odata.nextLink": null,
  "@odata.context": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest",
  "@odata.count": 2,
  "value": [
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest/$entity",
      "timestamp": "2019-10-09T18:42:42Z",
      "resourceId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/mysa1",
      "policyAssignmentId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyAssignments/3f3c4330183b4e218fe6fd29",
      "policyDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyDefinitions/24813039-7534-408a-9842-eb99f45721b1",
      "effectiveParameters": null,
      "isCompliant": false,
      "subscriptionId": "fffedd8f-ffff-fffd-fffd-fffed2f84852",
      "resourceType": "/Microsoft.Storage/storageAccounts",
      "resourceLocation": "eastus",
      "resourceGroup": "myResourceGroup",
      "resourceTags": "tbd",
      "policyAssignmentName": "3f3c4330183b4e218fe6fd29",
      "policyAssignmentOwner": "tbd",
      "policyAssignmentParameters": "{}",
      "policyAssignmentScope": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852",
      "policyDefinitionName": "24813039-7534-408a-9842-eb99f45721b1",
      "policyDefinitionAction": "audit",
      "policyDefinitionCategory": "tbd",
      "policySetDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policySetDefinitions/3e3807c1-65c9-49e0-a406-82d8ae3e338c",
      "policySetDefinitionName": "3e3807c1-65c9-49e0-a406-82d8ae3e338c",
      "policySetDefinitionOwner": null,
      "policySetDefinitionCategory": null,
      "policySetDefinitionParameters": null,
      "managementGroupIds": "mymg,fff988bf-fff1-ffff-fffb-fffcd011db47",
      "policyDefinitionReferenceId": null,
      "complianceState": "NonCompliant",
      "policyDefinitionGroupNames": [
        "myGroup"
      ]
    },
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest/$entity",
      "timestamp": "2019-10-09T18:42:42Z",
      "resourceId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/mysa1",
      "policyAssignmentId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyAssignments/3f3c4330183b4e218fe6fd29",
      "policyDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyDefinitions/3e3807c1-65c9-49e0-a406-82d8ae3e3682",
      "effectiveParameters": null,
      "isCompliant": true,
      "subscriptionId": "fffedd8f-ffff-fffd-fffd-fffed2f84852",
      "resourceType": "/Microsoft.Storage/storageAccounts",
      "resourceLocation": "eastus",
      "resourceGroup": "myResourceGroup",
      "resourceTags": "tbd",
      "policyAssignmentName": "3f3c4330183b4e218fe6fd29",
      "policyAssignmentOwner": "tbd",
      "policyAssignmentParameters": "{}",
      "policyAssignmentScope": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852",
      "policyDefinitionName": "3e3807c1-65c9-49e0-a406-82d8ae3e3682",
      "policyDefinitionAction": "audit",
      "policyDefinitionCategory": "tbd",
      "policySetDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policySetDefinitions/3e3807c1-65c9-49e0-a406-82d8ae3e338c",
      "policySetDefinitionName": "3e3807c1-65c9-49e0-a406-82d8ae3e338c",
      "policySetDefinitionOwner": null,
      "policySetDefinitionCategory": null,
      "policySetDefinitionParameters": null,
      "managementGroupIds": "mymg,fff988bf-fff1-ffff-fffb-fffcd011db47",
      "policyDefinitionReferenceId": null,
      "complianceState": "Compliant",
      "policyDefinitionGroupNames": [
        "myGroup"
      ]
    }
  ]
}

Tanımlar

Name	Description
ComponentStateDetails	Bileşen durumu ayrıntıları.
Error	Hata tanımı.
ExpressionEvaluationDetails	İlke dili ifadelerinin değerlendirme ayrıntıları.
IfNotExistsEvaluationDetails	IfNotExists etkisinin değerlendirme ayrıntıları.
PolicyEvaluationDetails	İlke değerlendirme ayrıntıları.
PolicyState	İlke durumu kaydı.
PolicyStatesQueryResults	Sorgu sonuçları.
PolicyStatesResource	PolicyStates kaynak türü altındaki sanal kaynak. Belirli bir zaman aralığında 'en son' en son ilke durumlarını, 'varsayılan' ise tüm ilke durumlarını temsil eder.
QueryFailure	Hata yanıtı.

ComponentStateDetails

Nesne

Bileşen durumu ayrıntıları.

Name	Tür	Description
complianceState	string	Bileşen uyumluluk durumu.
id	string	Bileşen Kimliği.
name	string	Bileşen adı.
timestamp	string (date-time)	Bileşen uyumluluğu değerlendirme zaman damgası.
type	string	Bileşen türü.

Error

Nesne

Hata tanımı.

Name	Tür	Description
code	string	HTTP hata kodu için alt durum olarak hizmet veren hizmete özgü hata kodu.
message	string	Hatanın açıklaması.

ExpressionEvaluationDetails

Nesne

İlke dili ifadelerinin değerlendirme ayrıntıları.

Name	Tür	Description
expression	string	İfade değerlendirildi.
expressionKind	string	Değerlendirilen ifade türü.
expressionValue	object	İfadenin değeri.
operator	string	İfade değerini ve hedef değeri karşılaştırmak için işleç.
path	string	İfade bir alan veya diğer adsa özellik yolu.
result	string	Değerlendirme sonucu.
targetValue	object	İfade değeriyle karşılaştırılacak hedef değer.

IfNotExistsEvaluationDetails

Nesne

IfNotExists etkisinin değerlendirme ayrıntıları.

Name	Tür	Description
resourceId	string	IfNotExists etkisi için son değerlendirilen kaynağın kimliği.
totalResources	integer	Varlık koşulunun geçerli olduğu toplam kaynak sayısı.

PolicyEvaluationDetails

Nesne

İlke değerlendirme ayrıntıları.

Name	Tür	Description
evaluatedExpressions	ExpressionEvaluationDetails[]	Değerlendirilen ifadelerin ayrıntıları.
ifNotExistsDetails	IfNotExistsEvaluationDetails	IfNotExists etkisinin değerlendirme ayrıntıları.

PolicyState

Nesne

İlke durumu kaydı.

Name	Tür	Description
@odata.context	string	OData bağlam dizesi; meta verileri temel alarak tür bilgilerini çözümlemek için OData istemcileri tarafından kullanılır.
@odata.id	string	OData varlık kimliği; İlke durumu kayıtlarının varlık kimliği olmadığından her zaman null olarak ayarlanır.
complianceState	string	Kaynağın uyumluluk durumu.
components	ComponentStateDetails[]	Bileşenler durumu uyumluluk kayıtları yalnızca URL $expand=components yan tümcesi içerdiğinde doldurulur.
effectiveParameters	string	İlke ataması için geçerli parametreler.
isCompliant	boolean	Kaynağın değerlendirildiği ilke atamasına göre uyumlu olup olmadığını gösteren bayrak. Bu özellik kullanım dışıdır; lütfen bunun yerine ComplianceState kullanın.
managementGroupIds	string	Kaynağın altında yer aldığı yönetim gruplarının hiyerarşisini temsil eden yönetim grubu kimliklerinin virgülle ayrılmış listesi.
policyAssignmentId	string	İlke atama kimliği.
policyAssignmentName	string	İlke atama adı.
policyAssignmentOwner	string	İlke ataması sahibi.
policyAssignmentParameters	string	İlke atama parametreleri.
policyAssignmentScope	string	İlke atama kapsamı.
policyAssignmentVersion	string	İlke atama sürümü değerlendirildi.
policyDefinitionAction	string	İlke tanımı eylemi, yani efekt.
policyDefinitionCategory	string	İlke tanımı kategorisi.
policyDefinitionGroupNames	string[]	İlke tanımı grup adları.
policyDefinitionId	string	İlke tanımı kimliği.
policyDefinitionName	string	İlke tanımı adı.
policyDefinitionReferenceId	string	İlke ataması bir ilke kümesine yönelikse, ilke kümesinin içindeki ilke tanımının başvuru kimliği.
policyDefinitionVersion	string	İlke tanımı sürümü değerlendirildi.
policyEvaluationDetails	PolicyEvaluationDetails	İlke değerlendirme ayrıntıları.
policySetDefinitionCategory	string	İlke ataması bir ilke kümesi içinse, ilke kümesi tanım kategorisi.
policySetDefinitionId	string	İlke ataması bir ilke kümesi içinse, ilke kümesi tanım kimliği.
policySetDefinitionName	string	İlke ataması bir ilke kümesi içinse, ilke kümesi tanım adı.
policySetDefinitionOwner	string	İlke ataması bir ilke kümesi içinse, ilke kümesi tanımı sahibi.
policySetDefinitionParameters	string	İlke ataması bir ilke kümesi içinse, ilke kümesi tanım parametreleri.
policySetDefinitionVersion	string	İlke kümesi tanım sürümü değerlendirildi.
resourceGroup	string	Kaynak grubu adı.
resourceId	string	Kaynak Kimliği.
resourceLocation	string	Kaynak konumu.
resourceTags	string	Kaynak etiketlerinin listesi.
resourceType	string	Kaynak türü.
subscriptionId	string	Abonelik Kimliği.
timestamp	string (date-time)	İlke durumu kaydı için zaman damgası.

PolicyStatesQueryResults

Nesne

Sorgu sonuçları.

Name	Tür	Description
@odata.context	string	OData bağlam dizesi; meta verileri temel alarak tür bilgilerini çözümlemek için OData istemcileri tarafından kullanılır.
@odata.count	integer (int32) minimum: 0	OData varlık sayısı; , döndürülen ilke durumu kayıtlarının sayısını temsil eder.
@odata.nextLink	string	Odata sonraki bağlantı; Sonraki sonuç kümesini almak için URL.
value	PolicyState[]	Sorgu sonuçları.

PolicyStatesResource

Numaralandırma

PolicyStates kaynak türü altındaki sanal kaynak. Belirli bir zaman aralığında 'en son' en son ilke durumlarını, 'varsayılan' ise tüm ilke durumlarını temsil eder.

Değer	Description
default
latest

QueryFailure

Nesne

Hata yanıtı.

Name	Tür	Description
error	Error	Hata tanımı.

Aracılığıyla paylaş

Policy States - List Query Results For Resource Group

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

Query latest at resource group scope

Örnek isteği

Örnek yanıt

Query latest at resource group scope with next link

Örnek isteği

Örnek yanıt

Tanımlar

ComponentStateDetails

Error

ExpressionEvaluationDetails

IfNotExistsEvaluationDetails

PolicyEvaluationDetails

PolicyState

PolicyStatesQueryResults

PolicyStatesResource

QueryFailure