Component Policy States - List Query Results For Subscription Level Policy Assignment
Dotazuje se na stavy zásad komponent pro přiřazení zásad na úrovni předplatného.
POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/componentPolicyStates/latest/queryResults?api-version=2022-04-01
POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/componentPolicyStates/latest/queryResults?api-version=2022-04-01&$top={$top}&$orderby={$orderby}&$select={$select}&$from={$from}&$to={$to}&$filter={$filter}&$apply={$apply}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
authorization
|
path | True |
Obor názvů pro poskytovatele prostředků autorizace Microsoftu; Je povolena pouze "Microsoft.Authorization". |
|
component
|
path | True |
Virtuální prostředek v části Typ prostředku ComponentPolicyStates V daném časovém rozsahu představuje nejnovější stav zásad komponent. |
|
policy
|
path | True |
string |
Název přiřazení zásad. Regex pattern: |
subscription
|
path | True |
string |
ID předplatného Microsoft Azure. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
$apply
|
query |
string |
Použití výrazu OData pro agregace |
|
$filter
|
query |
string |
Výraz filtru OData. |
|
$from
|
query |
string date-time |
Časové razítko ve formátu ISO 8601 určující počáteční čas intervalu, který se má dotazovat. Pokud není zadaný, služba použije ($to - 1 den). |
|
$orderby
|
query |
string |
Výraz řazení pomocí notace OData. Jeden nebo více názvů sloupců oddělených čárkami s volitelným "desc" (výchozí) nebo "asc", např. "$orderby=PolicyAssignmentId, ResourceId asc". |
|
$select
|
query |
string |
Select expression using OData notation.Select expression using OData notation. Omezí sloupce v každém záznamu jenom na požadované položky, například "$select=PolicyAssignmentId, ResourceId". |
|
$to
|
query |
string date-time |
Časové razítko ve formátu ISO 8601 určující koncový čas intervalu, který se má dotazovat. Pokud není zadaný, služba použije čas požadavku. |
|
$top
|
query |
integer int32 |
Maximální počet záznamů, které se mají vrátit. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Výsledky dotazu. |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Query latest at subscription level policy assignment scope
Sample Request
POST https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyAssignments/ec8f9645-8ecb-4abb-9c0b-5292f19d4003/providers/Microsoft.PolicyInsights/componentPolicyStates/latest/queryResults?api-version=2022-04-01
Sample Response
{
"@odata.context": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyAssignments/ec8f9645-8ecb-4abb-9c0b-5292f19d4003/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/providers/Microsoft.Authorization/policyAssignments/ec8f9645-8ecb-4abb-9c0b-5292f19d4003/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest/$entity",
"timestamp": "2022-04-09T16:04:31Z",
"componentId": "cert-RSA-cert-3",
"componentType": "Certificate",
"componentName": "cert-RSA-cert-3",
"resourceId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVault",
"policyAssignmentId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyAssignments/ec8f9645-8ecb-4abb-9c0b-5292f19d4003",
"policyDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyDefinitions/c8b79b49-a579-4045-984e-1b249ab8b474",
"subscriptionId": "fffedd8f-ffff-fffd-fffd-fffed2f84852",
"resourceType": "/Microsoft.KeyVault/vaults",
"resourceLocation": "eastus",
"resourceGroup": "myResourceGroup",
"policyAssignmentName": "ec8f9645-8ecb-4abb-9c0b-5292f19d4003",
"policyAssignmentOwner": "tbd",
"policyAssignmentParameters": null,
"policyAssignmentScope": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852",
"policyDefinitionName": "c8b79b49-a579-4045-984e-1b249ab8b474",
"policyDefinitionAction": "audit",
"policyDefinitionCategory": "tbd",
"policySetDefinitionId": null,
"policySetDefinitionName": null,
"policySetDefinitionOwner": null,
"policySetDefinitionCategory": null,
"policySetDefinitionParameters": null,
"policyDefinitionReferenceId": "2124621540977569058",
"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/providers/Microsoft.Authorization/policyAssignments/ec8f9645-8ecb-4abb-9c0b-5292f19d4003/providers/Microsoft.PolicyInsights/policyStates/$metadata#latest/$entity",
"timestamp": "2022-04-09T16:04:31Z",
"componentId": "cert-RSA-cert-3",
"componentType": "Certificate",
"componentName": "cert-RSA-cert-3",
"resourceId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVault",
"policyAssignmentId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyAssignments/ec8f9645-8ecb-4abb-9c0b-5292f19d4003",
"policyDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.Authorization/policyDefinitions/24813039-7534-408a-9842-eb99f45721b1",
"isCompliant": true,
"subscriptionId": "fffedd8f-ffff-fffd-fffd-fffed2f84852",
"resourceType": "/Microsoft.KeyVault/vaults",
"resourceLocation": "eastus",
"resourceGroup": "myResourceGroup",
"policyAssignmentName": "ec8f9645-8ecb-4abb-9c0b-5292f19d4003",
"policyAssignmentOwner": "tbd",
"policyAssignmentParameters": null,
"policyAssignmentScope": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852",
"policyDefinitionName": "24813039-7534-408a-9842-eb99f45721b1",
"policyDefinitionAction": "audit",
"policyDefinitionCategory": "tbd",
"policySetDefinitionId": null,
"policySetDefinitionName": null,
"policySetDefinitionOwner": null,
"policySetDefinitionCategory": null,
"policySetDefinitionParameters": null,
"policyDefinitionReferenceId": "14799174781370023846",
"complianceState": "Compliant",
"policyDefinitionGroupNames": [
"myGroup"
],
"policyDefinitionVersion": "1.0.0-preview",
"policySetDefinitionVersion": "2.0.1",
"policyAssignmentVersion": "1.0.0"
}
]
}
Definice
Name | Description |
---|---|
Authorization |
Obor názvů pro poskytovatele prostředků autorizace Microsoftu; Je povolena pouze "Microsoft.Authorization". |
Component |
Podrobnosti vyhodnocení výrazů jazyka zásad |
Component |
Podrobnosti o vyhodnocení zásad |
Component |
Záznam stavu zásad komponenty. |
Component |
Výsledky dotazu. |
Component |
Virtuální prostředek v části Typ prostředku ComponentPolicyStates V daném časovém rozsahu představuje nejnovější stav zásad komponent. |
Error |
Definice chyby. |
Error |
Chybová odpověď. |
Typed |
Podrobnosti o chybách specifických pro scénář |
AuthorizationNamespaceType
Obor názvů pro poskytovatele prostředků autorizace Microsoftu; Je povolena pouze "Microsoft.Authorization".
Name | Typ | Description |
---|---|---|
Microsoft.Authorization |
string |
ComponentExpressionEvaluationDetails
Podrobnosti vyhodnocení výrazů jazyka zásad
Name | Typ | Description |
---|---|---|
expression |
string |
Výraz byl vyhodnocen. |
expressionKind |
string |
Druh výrazu, který byl vyhodnocen. |
expressionValue |
object |
Hodnota výrazu |
operator |
string |
Operátor pro porovnání hodnoty výrazu a cílové hodnoty. |
path |
string |
Cesta k vlastnosti, pokud je výraz pole nebo alias. |
result |
string |
Výsledek vyhodnocení. |
targetValue |
object |
Cílová hodnota, která se má porovnat s hodnotou výrazu. |
ComponentPolicyEvaluationDetails
Podrobnosti o vyhodnocení zásad
Name | Typ | Description |
---|---|---|
evaluatedExpressions |
Podrobnosti o vyhodnocených výrazech |
|
reason |
string |
Další textový důvod pro výsledek vyhodnocení. |
ComponentPolicyState
Záznam stavu zásad komponenty.
Name | Typ | Description |
---|---|---|
@odata.context |
string |
Kontextový řetězec OData; používá klienty OData k překladu informací o typu na základě metadat. |
@odata.id |
string |
ID entity OData; Vlastnost vždy nastavená na hodnotu null, protože záznamy o stavu zásad součástí nemají ID entity. |
complianceState |
string |
Stav dodržování předpisů prostředku. |
componentId |
string |
ID komponenty. |
componentName |
string |
Název komponenty. |
componentType |
string |
Typ komponenty. |
policyAssignmentId |
string |
ID přiřazení zásad. |
policyAssignmentName |
string |
Název přiřazení zásad. |
policyAssignmentOwner |
string |
Vlastník přiřazení zásad. |
policyAssignmentParameters |
string |
Parametry přiřazení zásad. |
policyAssignmentScope |
string |
Obor přiřazení zásad. |
policyAssignmentVersion |
string |
Vyhodnocená verze přiřazení zásad |
policyDefinitionAction |
string |
Akce definice zásad, tj. účinek. |
policyDefinitionCategory |
string |
Kategorie definice zásad |
policyDefinitionGroupNames |
string[] |
Názvy skupin definic zásad. |
policyDefinitionId |
string |
ID definice zásady. |
policyDefinitionName |
string |
Název definice zásad. |
policyDefinitionReferenceId |
string |
Referenční ID pro definici zásady uvnitř sady zásad, pokud je přiřazení zásady pro sadu zásad. |
policyDefinitionVersion |
string |
Vyhodnocená verze definice zásad |
policyEvaluationDetails |
Podrobnosti o vyhodnocení zásad To je součástí odpovědi pouze v případě, že požadavek obsahuje $expand=PolicyEvaluationDetails. |
|
policySetDefinitionCategory |
string |
Kategorie definice sady zásad, pokud je přiřazení zásad pro sadu zásad. |
policySetDefinitionId |
string |
ID definice sady zásad, pokud je přiřazení zásady určené pro sadu zásad. |
policySetDefinitionName |
string |
Název definice sady zásad, pokud je přiřazení zásad pro sadu zásad. |
policySetDefinitionOwner |
string |
Vlastník definice sady zásad, pokud je přiřazení zásad pro sadu zásad. |
policySetDefinitionParameters |
string |
Parametry definice sady zásad, pokud je přiřazení zásad pro sadu zásad. |
policySetDefinitionVersion |
string |
Vyhodnocená verze definice sady zásad |
resourceGroup |
string |
Název skupiny prostředků. |
resourceId |
string |
ID prostředku. |
resourceLocation |
string |
Umístění prostředku. |
resourceType |
string |
Typ prostředku. |
subscriptionId |
string |
ID předplatného |
timestamp |
string |
Časové razítko záznamu o stavu zásad komponenty. |
ComponentPolicyStatesQueryResults
Výsledky dotazu.
Name | Typ | Description |
---|---|---|
@odata.context |
string |
Kontextový řetězec OData; používá klienty OData k překladu informací o typu na základě metadat. |
@odata.count |
integer |
Počet entit OData; představuje počet vrácených záznamů o stavu zásad. |
value |
Výsledky dotazu. |
ComponentPolicyStatesResource
Virtuální prostředek v části Typ prostředku ComponentPolicyStates V daném časovém rozsahu představuje nejnovější stav zásad komponent.
Name | Typ | Description |
---|---|---|
latest |
string |
ErrorDefinition
Definice chyby.
Name | Typ | Description |
---|---|---|
additionalInfo |
Další podrobnosti o chybách specifických pro scénář |
|
code |
string |
Kód chyby specifický pro službu, který slouží jako dílčí stav pro kód chyby HTTP. |
details |
Podrobnosti o vnitřní chybě. |
|
message |
string |
Popis chyby |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď.
Name | Typ | Description |
---|---|---|
error |
Podrobnosti o chybě. |
TypedErrorInfo
Podrobnosti o chybách specifických pro scénář
Name | Typ | Description |
---|---|---|
info |
Podrobnosti o chybách specifických pro scénář |
|
type |
string |
Typ zahrnutých podrobností o chybě. |