Policy Assignments - List For Resource Group
Récupère toutes les affectations de stratégie qui s’appliquent à un groupe de ressources.
Cette opération récupère la liste de toutes les affectations de stratégie associées au groupe de ressources donné dans l’abonnement donné qui correspondent à la $filter facultative donnée. Les valeurs valides pour $filter sont : « atScope() », « atExactScope() » ou « policyDefinitionId eq « {value} ». Si $filter n’est pas fourni, la liste non filtrée inclut toutes les affectations de stratégies associées au groupe de ressources, y compris celles qui s’appliquent directement ou s’appliquent à partir d’étendues contenantes, ainsi que toutes les affectations appliquées aux ressources contenues dans le groupe de ressources. Si $filter=atScope() est fourni, la liste retournée inclut toutes les affectations de stratégie qui s’appliquent au groupe de ressources, à savoir tout ce qui se trouve dans la liste non filtrée, à l’exception de celles appliquées aux ressources contenues dans le groupe de ressources. Si $filter=atExactScope() est fourni, la liste retournée inclut uniquement toutes les affectations de stratégie au niveau du groupe de ressources. Si $filter=policyDefinitionId eq « {value} » est fourni, la liste retournée inclut toutes les affectations de stratégie de la définition de stratégie dont l’ID est {value} qui s’appliquent au groupe de ressources.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/policyAssignments?api-version=2023-04-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/policyAssignments?$filter={$filter}&$top={$top}&api-version=2023-04-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nom du groupe de ressources qui contient les affectations de stratégie. Regex pattern: |
subscription
|
path | True |
string uuid |
ID de l’abonnement cible. La valeur doit être un UUID. |
api-version
|
query | True |
string |
Version de l’API à utiliser pour cette opération. |
$filter
|
query |
string |
Filtre à appliquer à l’opération. Les valeurs valides pour $filter sont : « atScope() », « atExactScope() » ou « policyDefinitionId eq « {value} ». Si $filter n’est pas fourni, aucun filtrage n’est effectué. Si $filter=atScope() est fourni, la liste retournée inclut uniquement toutes les affectations de stratégie qui s’appliquent à l’étendue, à savoir tout ce qui se trouve dans la liste non filtrée, à l’exception de celles appliquées aux sous-étendues contenues dans l’étendue donnée. Si $filter=atExactScope() est fourni, la liste retournée inclut uniquement toutes les affectations de stratégie qui se situent dans l’étendue donnée. Si $filter=policyDefinitionId eq « {value} » est fourni, la liste retournée inclut toutes les affectations de stratégie de la définition de stratégie dont l’ID est {value}. |
|
$top
|
query |
integer int32 |
Nombre maximal d’enregistrements à retourner. Lorsque le filtre $top n’est pas fourni, il retourne 500 enregistrements. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
OK : retourne un tableau d’affectations de stratégie. |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
List policy assignments that apply to a resource group
Sample Request
GET https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup/providers/Microsoft.Authorization/policyAssignments?$filter=atScope()&api-version=2023-04-01
Sample Response
{
"value": [
{
"id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup/providers/Microsoft.Authorization/policyAssignments/TestCostManagement",
"type": "Microsoft.Authorization/policyAssignments",
"name": "TestCostManagement",
"location": "eastus",
"identity": {
"type": "SystemAssigned",
"principalId": "e6d23f8d-af97-4fbc-bda6-00604e4e3d0a",
"tenantId": "4bee2b8a-1bee-47c2-90e9-404241551135"
},
"properties": {
"displayName": "Storage Cost Management",
"description": "Minimize the risk of accidental cost overruns",
"metadata": {
"category": "Cost Management"
},
"policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/storageSkus",
"parameters": {
"allowedSkus": {
"value": "Standard_A1"
}
},
"scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup",
"notScopes": []
}
},
{
"id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup/providers/Microsoft.Authorization/policyAssignments/TestTagEnforcement",
"type": "Microsoft.Authorization/policyAssignments",
"name": "TestTagEnforcement",
"properties": {
"displayName": "Enforces a tag key and value",
"description": "Ensure a given tag key and value are present on all resources",
"policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/TagKeyValue",
"scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup",
"notScopes": []
}
}
]
}
Définitions
Nom | Description |
---|---|
Cloud |
Réponse d’erreur d’une opération de stratégie. |
created |
Type d’identité qui a créé la ressource. |
enforcement |
Mode d’application de l’attribution de stratégie. Les valeurs possibles sont Default et DoNotEnforce. |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Réponse d’erreur |
Identity |
Identité de la ressource. Les affectations de stratégie prennent en charge un maximum d’une identité. Il s’agit d’une identité affectée par le système ou d’une identité affectée par l’utilisateur unique. |
Non |
Message qui décrit la raison pour laquelle une ressource n’est pas conforme à la stratégie. Cela est indiqué dans les messages d’erreur « refuser » et dans les résultats de conformité non conformes de la ressource. |
Override |
La valeur de la propriété de stratégie remplace. |
Override |
Type de remplacement. |
Parameter |
Valeur d’un paramètre. |
Policy |
Affectation de stratégie. |
Policy |
Liste des affectations de stratégie. |
Resource |
Type d’identité. Il s’agit du seul champ obligatoire lors de l’ajout d’une identité affectée par le système ou l’utilisateur à une ressource. |
Resource |
Sélecteur de ressources permettant de filtrer les stratégies par propriétés de ressource. |
Selector |
Expression du sélecteur. |
Selector |
Type de sélecteur. |
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
User |
Identité de l’utilisateur associée à la stratégie. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ». |
CloudError
Réponse d’erreur d’une opération de stratégie.
Nom | Type | Description |
---|---|---|
error |
Réponse d’erreur |
createdByType
Type d’identité qui a créé la ressource.
Nom | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
enforcementMode
Mode d’application de l’attribution de stratégie. Les valeurs possibles sont Default et DoNotEnforce.
Nom | Type | Description |
---|---|---|
Default |
string |
L’effet de stratégie est appliqué pendant la création ou la mise à jour d’une ressource. |
DoNotEnforce |
string |
L’effet de stratégie n’est pas appliqué lors de la création ou de la mise à jour des ressources. |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
Nom | Type | Description |
---|---|---|
info |
object |
Informations supplémentaires |
type |
string |
Type d’informations supplémentaires. |
ErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
additionalInfo |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d'erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
Identity
Identité de la ressource. Les affectations de stratégie prennent en charge un maximum d’une identité. Il s’agit d’une identité affectée par le système ou d’une identité affectée par l’utilisateur unique.
Nom | Type | Description |
---|---|---|
principalId |
string |
ID principal de l’identité de ressource. Cette propriété est fournie uniquement pour une identité affectée par le système |
tenantId |
string |
ID de locataire de l’identité de ressource. Cette propriété est fournie uniquement pour une identité affectée par le système |
type |
Type d’identité. Il s’agit du seul champ obligatoire lors de l’ajout d’une identité affectée par le système ou l’utilisateur à une ressource. |
|
userAssignedIdentities |
Identité de l’utilisateur associée à la stratégie. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ». |
NonComplianceMessage
Message qui décrit la raison pour laquelle une ressource n’est pas conforme à la stratégie. Cela est indiqué dans les messages d’erreur « refuser » et dans les résultats de conformité non conformes de la ressource.
Nom | Type | Description |
---|---|---|
message |
string |
Message qui décrit la raison pour laquelle une ressource n’est pas conforme à la stratégie. Cela est indiqué dans les messages d’erreur « refuser » et dans les résultats de conformité non conformes de la ressource. |
policyDefinitionReferenceId |
string |
ID de référence de définition de stratégie dans une définition de jeu de stratégies pour laquelle le message est destiné. Cela s’applique uniquement si l’affectation de stratégie affecte une définition de jeu de stratégies. Si ce n’est pas fourni, le message s’applique à toutes les stratégies affectées par cette attribution de stratégie. |
Override
La valeur de la propriété de stratégie remplace.
Nom | Type | Description |
---|---|---|
kind |
Type de remplacement. |
|
selectors |
Selector[] |
Liste des expressions du sélecteur. |
value |
string |
Valeur à remplacer la propriété de stratégie. |
OverrideKind
Type de remplacement.
Nom | Type | Description |
---|---|---|
policyEffect |
string |
Il remplacera le type d’effet de stratégie. |
ParameterValuesValue
Valeur d’un paramètre.
Nom | Type | Description |
---|---|---|
value |
object |
Valeur du paramètre. |
PolicyAssignment
Affectation de stratégie.
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
id |
string |
ID de l’affectation de stratégie. |
|
identity |
Identité managée associée à l’attribution de stratégie. |
||
location |
string |
Emplacement de l’affectation de stratégie. Obligatoire uniquement lors de l’utilisation de l’identité managée. |
|
name |
string |
Nom de l’affectation de stratégie. |
|
properties.description |
string |
Ce message fera partie de la réponse en cas de violation de stratégie. |
|
properties.displayName |
string |
Nom complet de l’affectation de stratégie. |
|
properties.enforcementMode | Default |
Mode d’application de l’attribution de stratégie. Les valeurs possibles sont Default et DoNotEnforce. |
|
properties.metadata |
object |
Métadonnées d’affectation de stratégie. Les métadonnées sont un objet ouvert et sont généralement une collection de paires clé-valeur. |
|
properties.nonComplianceMessages |
Messages décrivant la raison pour laquelle une ressource n’est pas conforme à la stratégie. |
||
properties.notScopes |
string[] |
Étendues exclues de la stratégie. |
|
properties.overrides |
Override[] |
La valeur de la propriété de stratégie remplace. |
|
properties.parameters |
<string,
Parameter |
Valeurs de paramètre pour la règle de stratégie affectée. Les clés sont les noms des paramètres. |
|
properties.policyDefinitionId |
string |
ID de la définition de stratégie ou de la définition d’ensemble de stratégies affectée. |
|
properties.resourceSelectors |
Liste de sélecteurs de ressources pour filtrer les stratégies par propriétés de ressource. |
||
properties.scope |
string |
Étendue de l’attribution de stratégie. |
|
systemData |
Métadonnées système relatives à cette ressource. |
||
type |
string |
Type de l’affectation de stratégie. |
PolicyAssignmentListResult
Liste des affectations de stratégie.
Nom | Type | Description |
---|---|---|
nextLink |
string |
URL à utiliser pour obtenir l’ensemble de résultats suivant. |
value |
Tableau d’affectations de stratégie. |
ResourceIdentityType
Type d’identité. Il s’agit du seul champ obligatoire lors de l’ajout d’une identité affectée par le système ou l’utilisateur à une ressource.
Nom | Type | Description |
---|---|---|
None |
string |
Indique qu’aucune identité n’est associée à la ressource ou que l’identité existante doit être supprimée. |
SystemAssigned |
string |
Indique qu’une identité affectée par le système est associée à la ressource. |
UserAssigned |
string |
Indique qu’une identité affectée par le système est associée à la ressource. |
ResourceSelector
Sélecteur de ressources permettant de filtrer les stratégies par propriétés de ressource.
Nom | Type | Description |
---|---|---|
name |
string |
Nom du sélecteur de ressources. |
selectors |
Selector[] |
Liste des expressions du sélecteur. |
Selector
Expression du sélecteur.
Nom | Type | Description |
---|---|---|
in |
string[] |
Liste des valeurs à filtrer. |
kind |
Type de sélecteur. |
|
notIn |
string[] |
Liste des valeurs à filtrer. |
SelectorKind
Type de sélecteur.
Nom | Type | Description |
---|---|---|
policyDefinitionReferenceId |
string |
Type de sélecteur permettant de filtrer les stratégies par l’ID de référence de définition de stratégie. |
resourceLocation |
string |
Type de sélecteur permettant de filtrer les stratégies en fonction de l’emplacement de la ressource. |
resourceType |
string |
Type de sélecteur permettant de filtrer les stratégies par type de ressource. |
resourceWithoutLocation |
string |
Type de sélecteur permettant de filtrer les stratégies par ressource sans emplacement. |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
Nom | Type | Description |
---|---|---|
createdAt |
string |
Horodatage de la création de ressources (UTC). |
createdBy |
string |
Identité qui a créé la ressource. |
createdByType |
Type d’identité qui a créé la ressource. |
|
lastModifiedAt |
string |
Horodatage de la dernière modification de la ressource (UTC) |
lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |
UserAssignedIdentities
Identité de l’utilisateur associée à la stratégie. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».
Nom | Type | Description |
---|---|---|
|