Share via


PolicyDefinitionsOperationsExtensions.ListByManagementGroupAsync Method

Definition

Retrieve policy definitions in a management group

public static System.Threading.Tasks.Task<Microsoft.Rest.Azure.IPage<Microsoft.Azure.Management.ResourceManager.Models.PolicyDefinition>> ListByManagementGroupAsync (this Microsoft.Azure.Management.ResourceManager.IPolicyDefinitionsOperations operations, string managementGroupId, string filter = default, int? top = default, System.Threading.CancellationToken cancellationToken = default);
static member ListByManagementGroupAsync : Microsoft.Azure.Management.ResourceManager.IPolicyDefinitionsOperations * string * string * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.IPage<Microsoft.Azure.Management.ResourceManager.Models.PolicyDefinition>>
<Extension()>
Public Function ListByManagementGroupAsync (operations As IPolicyDefinitionsOperations, managementGroupId As String, Optional filter As String = Nothing, Optional top As Nullable(Of Integer) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPage(Of PolicyDefinition))

Parameters

operations
IPolicyDefinitionsOperations

The operations group for this extension method.

managementGroupId
String

The ID of the management group.

filter
String

The filter to apply on the operation. Valid values for $filter are: 'atExactScope()', 'policyType -eq {value}' or 'category eq '{value}''. If $filter is not provided, no filtering is performed. If $filter=atExactScope() is provided, the returned list only includes all policy definitions that at the given scope. If $filter='policyType -eq {value}' is provided, the returned list only includes all policy definitions whose type match the {value}. Possible policyType values are NotSpecified, BuiltIn, Custom, and Static. If $filter='category -eq {value}' is provided, the returned list only includes all policy definitions whose category match the {value}.

top
Nullable<Int32>

Maximum number of records to return. When the $top filter is not provided, it will return 500 records.

cancellationToken
CancellationToken

The cancellation token.

Returns

Remarks

This operation retrieves a list of all the policy definitions in a given management group that match the optional given $filter. Valid values for $filter are: 'atExactScope()', 'policyType -eq {value}' or 'category eq '{value}''. If $filter is not provided, the unfiltered list includes all policy definitions associated with the management group, including those that apply directly or from management groups that contain the given management group. If $filter=atExactScope() is provided, the returned list only includes all policy definitions that at the given management group. If $filter='policyType -eq {value}' is provided, the returned list only includes all policy definitions whose type match the {value}. Possible policyType values are NotSpecified, BuiltIn, Custom, and Static. If $filter='category -eq {value}' is provided, the returned list only includes all policy definitions whose category match the {value}.

Applies to