Freigeben über


PolicyAssignments interface

Schnittstelle, die eine PolicyAssignments darstellt.

Methoden

create(string, string, PolicyAssignment, PolicyAssignmentsCreateOptionalParams)

Dieser Vorgang erstellt oder aktualisiert eine Richtlinienzuweisung mit dem angegebenen Bereich und Namen. Richtlinienzuweisungen gelten für alle Ressourcen, die in ihrem Bereich enthalten sind. Wenn Sie beispielsweise eine Richtlinie im Ressourcengruppenbereich zuweisen, gilt diese Richtlinie für alle Ressourcen in der Gruppe.

createById(string, PolicyAssignment, PolicyAssignmentsCreateByIdOptionalParams)

Dieser Vorgang erstellt oder aktualisiert die Richtlinienzuweisung mit der angegebenen ID. Richtlinienzuweisungen, die in einem Bereich vorgenommen werden, gelten für alle Ressourcen, die in diesem Bereich enthalten sind. Wenn Sie beispielsweise einer Ressourcengruppe eine Richtlinie zuweisen, gilt diese Richtlinie für alle Ressourcen in der Gruppe. Richtlinienzuweisungs-IDs weisen dieses Format auf: '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'.

delete(string, string, PolicyAssignmentsDeleteOptionalParams)

Dieser Vorgang löscht eine Richtlinienzuweisung, wobei ihr Name und der Bereich angegeben wurde, in dem sie erstellt wurde. Der Gültigkeitsbereich einer Richtlinienzuweisung ist der Teil seiner ID vor "/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

deleteById(string, PolicyAssignmentsDeleteByIdOptionalParams)

Dieser Vorgang löscht die Richtlinie mit der angegebenen ID. Richtlinienzuweisungs-IDs weisen dieses Format auf: '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'. Gültige Formate für {scope} sind: '/providers/Microsoft.Management/managementGroups/{managementGroup}' (Verwaltungsgruppe), '/subscriptions/{subscriptionId}' (Abonnement), '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName }' (Ressourcengruppe) oder '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}' (Ressource).

get(string, string, PolicyAssignmentsGetOptionalParams)

Dieser Vorgang ruft eine einzelne Richtlinienzuweisung anhand des Namens und des Bereichs ab, unter dem er erstellt wurde.

getById(string, PolicyAssignmentsGetByIdOptionalParams)

Der Vorgang ruft die Richtlinienzuweisung mit der angegebenen ID ab. Richtlinienzuweisungs-IDs weisen dieses Format auf: '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'.

list(PolicyAssignmentsListOptionalParams)

Dieser Vorgang ruft die Liste aller Richtlinienzuweisungen ab, die dem angegebenen Abonnement zugeordnet sind, die mit dem optionalen angegebenen $filter übereinstimmen. Gültige Werte für $filter sind: 'atScope()', 'atExactScope()' oder 'policyDefinitionId eq '{value}'. Wenn $filter nicht bereitgestellt wird, enthält die nicht gefilterte Liste alle dem Abonnement zugeordneten Richtlinienzuweisungen, einschließlich derJenigen, die direkt oder von Verwaltungsgruppen gelten, die das angegebene Abonnement enthalten, sowie alle angewendeten Objekte, die im Abonnement enthalten sind. Wenn $filter=atScope() angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen, die für das Abonnement gelten. Dies ist alles in der nicht gefilterten Liste, mit Ausnahme derjenigen, die auf Objekte im Abonnement angewendet wurden. Wenn $filter=atExactScope() angegeben wird, enthält die zurückgegebene Liste nur alle Richtlinienzuweisungen, die im Abonnement vorhanden sind. Wenn $filter=policyDefinitionId eq '{value}' bereitgestellt wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID {value} lautet.

listForManagementGroup(string, PolicyAssignmentsListForManagementGroupOptionalParams)

Dieser Vorgang ruft die Liste aller Richtlinienzuweisungen ab, die für die Verwaltungsgruppe gelten, die dem angegebenen $filter entsprechen. Gültige Werte für $filter sind: 'atScope()', 'atExactScope()' oder 'policyDefinitionId eq '{value}'. Wenn $filter=atScope() angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen, die der Verwaltungsgruppe oder den Vorgängern der Verwaltungsgruppe zugewiesen sind. Wenn $filter=atExactScope() angegeben wird, enthält die zurückgegebene Liste nur alle Richtlinienzuweisungen, die sich in der Verwaltungsgruppe befinden. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID "{value}" für die Verwaltungsgruppe gilt.

listForResource(string, string, string, string, string, PolicyAssignmentsListForResourceOptionalParams)

Mit diesem Vorgang wird die Liste aller Richtlinienzuordnungen abgerufen, die der angegebenen Ressource in der angegebenen Ressourcengruppe und dem Abonnement zugeordnet sind, die dem optionalen $filter entsprechen. Gültige Werte für $filter sind: 'atScope()', 'atExactScope()' oder 'policyDefinitionId eq '{value}'. Wenn $filter nicht bereitgestellt wird, enthält die nicht gefilterte Liste alle richtlinienzuordnungen, die der Ressource zugeordnet sind, einschließlich derJenigen, die direkt oder von allen enthaltenden Bereichen gelten, sowie alle angewendeten Ressourcen, die in der Ressource enthalten sind. Wenn $filter=atScope() angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen, die für die Ressource gelten, was alles in der nicht gefilterten Liste ist, mit Ausnahme derjenigen, die auf Ressourcen angewendet wurden, die in der Ressource enthalten sind. Wenn $filter=atExactScope() bereitgestellt wird, enthält die zurückgegebene Liste nur alle Richtlinienzuordnungen auf Ressourcenebene. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID {value} ist, die für die Ressource gelten. Drei Parameter plus der Ressourcenname werden verwendet, um eine bestimmte Ressource zu identifizieren. Wenn die Ressource nicht Teil einer übergeordneten Ressource ist (der häufigere Fall), sollte der übergeordnete Ressourcenpfad nicht bereitgestellt werden (oder als ''). Beispielsweise könnte eine Web-App als ({resourceProviderNamespace} == 'Microsoft.Web', {parentResourcePath} == '', {resourceType} == 'sites', {resourceName} == 'MyWebApp' angegeben werden. Wenn die Ressource Teil einer übergeordneten Ressource ist, sollten alle Parameter bereitgestellt werden. Beispielsweise könnte ein DNS-Name des virtuellen Computers als ({resourceProviderNamespace} == 'Microsoft.Compute', {parentResourcePath} == 'virtualMachines/MyVirtualMachine', {resourceType} == 'domainNames', {resourceName} == 'MyComputerName' angegeben werden). Eine bequeme Alternative zur getrennten Bereitstellung des Namespaces und typnamens besteht darin, beide im {resourceType}-Parameter, Format: ({resourceProviderNamespace} == '', {parentResourcePath} == '', {resourceType} == 'Microsoft.Web/sites', {resourceName} == 'MyWebApp').

listForResourceGroup(string, PolicyAssignmentsListForResourceGroupOptionalParams)

Dieser Vorgang ruft die Liste aller Richtlinienzuordnungen ab, die der angegebenen Ressourcengruppe im angegebenen Abonnement zugeordnet sind, die mit dem optionalen $filter übereinstimmen. Gültige Werte für $filter sind: 'atScope()', 'atExactScope()' oder 'policyDefinitionId eq '{value}'. Wenn $filter nicht angegeben wird, enthält die nicht gefilterte Liste alle richtlinienzuordnungen, die der Ressourcengruppe zugeordnet sind, einschließlich derjenigen, die direkt angewendet oder aus den enthaltenden Bereichen angewendet werden, sowie alle angewendeten Ressourcen, die in der Ressourcengruppe enthalten sind. Wenn $filter=atScope() angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen, die für die Ressourcengruppe gelten, was alles in der nicht gefilterten Liste ist, mit Ausnahme derjenigen, die auf Ressourcen in der Ressourcengruppe angewendet wurden. Wenn $filter=atExactScope() bereitgestellt wird, enthält die zurückgegebene Liste nur alle Richtlinienzuordnungen, die sich in der Ressourcengruppe befinden. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuordnungen der Richtliniendefinition, deren ID {value} ist, die für die Ressourcengruppe gelten.

update(string, string, PolicyAssignmentUpdate, PolicyAssignmentsUpdateOptionalParams)

Dieser Vorgang aktualisiert eine Richtlinienzuweisung mit dem angegebenen Bereich und Namen. Richtlinienzuweisungen gelten für alle Ressourcen, die in ihrem Bereich enthalten sind. Wenn Sie beispielsweise eine Richtlinie im Ressourcengruppenbereich zuweisen, gilt diese Richtlinie für alle Ressourcen in der Gruppe.

updateById(string, PolicyAssignmentUpdate, PolicyAssignmentsUpdateByIdOptionalParams)

Dieser Vorgang aktualisiert die Richtlinienzuweisung mit der angegebenen ID. Richtlinienzuweisungen, die in einem Bereich vorgenommen werden, gelten für alle Ressourcen, die in diesem Bereich enthalten sind. Wenn Sie beispielsweise einer Ressourcengruppe eine Richtlinie zuweisen, gilt diese Richtlinie für alle Ressourcen in der Gruppe. Richtlinienzuweisungs-IDs weisen dieses Format auf: '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'.

Details zur Methode

create(string, string, PolicyAssignment, PolicyAssignmentsCreateOptionalParams)

Dieser Vorgang erstellt oder aktualisiert eine Richtlinienzuweisung mit dem angegebenen Bereich und Namen. Richtlinienzuweisungen gelten für alle Ressourcen, die in ihrem Bereich enthalten sind. Wenn Sie beispielsweise eine Richtlinie im Ressourcengruppenbereich zuweisen, gilt diese Richtlinie für alle Ressourcen in der Gruppe.

function create(scope: string, policyAssignmentName: string, parameters: PolicyAssignment, options?: PolicyAssignmentsCreateOptionalParams): Promise<PolicyAssignment>

Parameter

scope

string

Der Bereich der Richtlinienzuweisung. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

policyAssignmentName

string

Der Name der Richtlinienzuweisung.

parameters
PolicyAssignment

Parameter für die Richtlinienzuweisung.

options
PolicyAssignmentsCreateOptionalParams

Die Optionsparameter.

Gibt zurück

Promise<PolicyAssignment>

createById(string, PolicyAssignment, PolicyAssignmentsCreateByIdOptionalParams)

Dieser Vorgang erstellt oder aktualisiert die Richtlinienzuweisung mit der angegebenen ID. Richtlinienzuweisungen, die in einem Bereich vorgenommen werden, gelten für alle Ressourcen, die in diesem Bereich enthalten sind. Wenn Sie beispielsweise einer Ressourcengruppe eine Richtlinie zuweisen, gilt diese Richtlinie für alle Ressourcen in der Gruppe. Richtlinienzuweisungs-IDs weisen dieses Format auf: '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'.

function createById(policyAssignmentId: string, parameters: PolicyAssignment, options?: PolicyAssignmentsCreateByIdOptionalParams): Promise<PolicyAssignment>

Parameter

policyAssignmentId

string

Die ID der zu erstellenden Richtlinienzuweisung. Verwenden Sie das Format "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

parameters
PolicyAssignment

Parameter für die Richtlinienzuweisung.

options
PolicyAssignmentsCreateByIdOptionalParams

Die Optionsparameter.

Gibt zurück

Promise<PolicyAssignment>

delete(string, string, PolicyAssignmentsDeleteOptionalParams)

Dieser Vorgang löscht eine Richtlinienzuweisung, wobei ihr Name und der Bereich angegeben wurde, in dem sie erstellt wurde. Der Gültigkeitsbereich einer Richtlinienzuweisung ist der Teil seiner ID vor "/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

function delete(scope: string, policyAssignmentName: string, options?: PolicyAssignmentsDeleteOptionalParams): Promise<PolicyAssignment>

Parameter

scope

string

Der Bereich der Richtlinienzuweisung. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

policyAssignmentName

string

Der Name der zu löschenden Richtlinienzuweisung.

options
PolicyAssignmentsDeleteOptionalParams

Die Optionsparameter.

Gibt zurück

Promise<PolicyAssignment>

deleteById(string, PolicyAssignmentsDeleteByIdOptionalParams)

Dieser Vorgang löscht die Richtlinie mit der angegebenen ID. Richtlinienzuweisungs-IDs weisen dieses Format auf: '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'. Gültige Formate für {scope} sind: '/providers/Microsoft.Management/managementGroups/{managementGroup}' (Verwaltungsgruppe), '/subscriptions/{subscriptionId}' (Abonnement), '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName }' (Ressourcengruppe) oder '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}' (Ressource).

function deleteById(policyAssignmentId: string, options?: PolicyAssignmentsDeleteByIdOptionalParams): Promise<PolicyAssignment>

Parameter

policyAssignmentId

string

Die ID der zu löschenden Richtlinienzuweisung. Verwenden Sie das Format "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

options
PolicyAssignmentsDeleteByIdOptionalParams

Die Optionsparameter.

Gibt zurück

Promise<PolicyAssignment>

get(string, string, PolicyAssignmentsGetOptionalParams)

Dieser Vorgang ruft eine einzelne Richtlinienzuweisung anhand des Namens und des Bereichs ab, unter dem er erstellt wurde.

function get(scope: string, policyAssignmentName: string, options?: PolicyAssignmentsGetOptionalParams): Promise<PolicyAssignment>

Parameter

scope

string

Der Bereich der Richtlinienzuweisung. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

policyAssignmentName

string

Der Name der abzurufenden Richtlinienzuweisung.

options
PolicyAssignmentsGetOptionalParams

Die Optionsparameter.

Gibt zurück

Promise<PolicyAssignment>

getById(string, PolicyAssignmentsGetByIdOptionalParams)

Der Vorgang ruft die Richtlinienzuweisung mit der angegebenen ID ab. Richtlinienzuweisungs-IDs weisen dieses Format auf: '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'.

function getById(policyAssignmentId: string, options?: PolicyAssignmentsGetByIdOptionalParams): Promise<PolicyAssignment>

Parameter

policyAssignmentId

string

Die ID der abzurufenden Richtlinienzuweisung. Verwenden Sie das Format "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

options
PolicyAssignmentsGetByIdOptionalParams

Die Optionsparameter.

Gibt zurück

Promise<PolicyAssignment>

list(PolicyAssignmentsListOptionalParams)

Dieser Vorgang ruft die Liste aller Richtlinienzuweisungen ab, die dem angegebenen Abonnement zugeordnet sind, die mit dem optionalen angegebenen $filter übereinstimmen. Gültige Werte für $filter sind: 'atScope()', 'atExactScope()' oder 'policyDefinitionId eq '{value}'. Wenn $filter nicht bereitgestellt wird, enthält die nicht gefilterte Liste alle dem Abonnement zugeordneten Richtlinienzuweisungen, einschließlich derJenigen, die direkt oder von Verwaltungsgruppen gelten, die das angegebene Abonnement enthalten, sowie alle angewendeten Objekte, die im Abonnement enthalten sind. Wenn $filter=atScope() angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen, die für das Abonnement gelten. Dies ist alles in der nicht gefilterten Liste, mit Ausnahme derjenigen, die auf Objekte im Abonnement angewendet wurden. Wenn $filter=atExactScope() angegeben wird, enthält die zurückgegebene Liste nur alle Richtlinienzuweisungen, die im Abonnement vorhanden sind. Wenn $filter=policyDefinitionId eq '{value}' bereitgestellt wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID {value} lautet.

function list(options?: PolicyAssignmentsListOptionalParams): PagedAsyncIterableIterator<PolicyAssignment, PolicyAssignment[], PageSettings>

Parameter

options
PolicyAssignmentsListOptionalParams

Die Optionsparameter.

Gibt zurück

listForManagementGroup(string, PolicyAssignmentsListForManagementGroupOptionalParams)

Dieser Vorgang ruft die Liste aller Richtlinienzuweisungen ab, die für die Verwaltungsgruppe gelten, die dem angegebenen $filter entsprechen. Gültige Werte für $filter sind: 'atScope()', 'atExactScope()' oder 'policyDefinitionId eq '{value}'. Wenn $filter=atScope() angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen, die der Verwaltungsgruppe oder den Vorgängern der Verwaltungsgruppe zugewiesen sind. Wenn $filter=atExactScope() angegeben wird, enthält die zurückgegebene Liste nur alle Richtlinienzuweisungen, die sich in der Verwaltungsgruppe befinden. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID "{value}" für die Verwaltungsgruppe gilt.

function listForManagementGroup(managementGroupId: string, options?: PolicyAssignmentsListForManagementGroupOptionalParams): PagedAsyncIterableIterator<PolicyAssignment, PolicyAssignment[], PageSettings>

Parameter

managementGroupId

string

Die ID der Verwaltungsgruppe.

Gibt zurück

listForResource(string, string, string, string, string, PolicyAssignmentsListForResourceOptionalParams)

Mit diesem Vorgang wird die Liste aller Richtlinienzuordnungen abgerufen, die der angegebenen Ressource in der angegebenen Ressourcengruppe und dem Abonnement zugeordnet sind, die dem optionalen $filter entsprechen. Gültige Werte für $filter sind: 'atScope()', 'atExactScope()' oder 'policyDefinitionId eq '{value}'. Wenn $filter nicht bereitgestellt wird, enthält die nicht gefilterte Liste alle richtlinienzuordnungen, die der Ressource zugeordnet sind, einschließlich derJenigen, die direkt oder von allen enthaltenden Bereichen gelten, sowie alle angewendeten Ressourcen, die in der Ressource enthalten sind. Wenn $filter=atScope() angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen, die für die Ressource gelten, was alles in der nicht gefilterten Liste ist, mit Ausnahme derjenigen, die auf Ressourcen angewendet wurden, die in der Ressource enthalten sind. Wenn $filter=atExactScope() bereitgestellt wird, enthält die zurückgegebene Liste nur alle Richtlinienzuordnungen auf Ressourcenebene. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID {value} ist, die für die Ressource gelten. Drei Parameter plus der Ressourcenname werden verwendet, um eine bestimmte Ressource zu identifizieren. Wenn die Ressource nicht Teil einer übergeordneten Ressource ist (der häufigere Fall), sollte der übergeordnete Ressourcenpfad nicht bereitgestellt werden (oder als ''). Beispielsweise könnte eine Web-App als ({resourceProviderNamespace} == 'Microsoft.Web', {parentResourcePath} == '', {resourceType} == 'sites', {resourceName} == 'MyWebApp' angegeben werden. Wenn die Ressource Teil einer übergeordneten Ressource ist, sollten alle Parameter bereitgestellt werden. Beispielsweise könnte ein DNS-Name des virtuellen Computers als ({resourceProviderNamespace} == 'Microsoft.Compute', {parentResourcePath} == 'virtualMachines/MyVirtualMachine', {resourceType} == 'domainNames', {resourceName} == 'MyComputerName' angegeben werden). Eine bequeme Alternative zur getrennten Bereitstellung des Namespaces und typnamens besteht darin, beide im {resourceType}-Parameter, Format: ({resourceProviderNamespace} == '', {parentResourcePath} == '', {resourceType} == 'Microsoft.Web/sites', {resourceName} == 'MyWebApp').

function listForResource(resourceGroupName: string, resourceProviderNamespace: string, parentResourcePath: string, resourceType: string, resourceName: string, options?: PolicyAssignmentsListForResourceOptionalParams): PagedAsyncIterableIterator<PolicyAssignment, PolicyAssignment[], PageSettings>

Parameter

resourceGroupName

string

Der Name der Ressourcengruppe, die die Ressource enthält.

resourceProviderNamespace

string

Der Namespace des Ressourcenanbieters. Beispielsweise ist der Namespace eines virtuellen Computers Microsoft.Compute (von Microsoft.Compute/virtualMachines)

parentResourcePath

string

Der übergeordnete Ressourcenpfad. Verwenden Sie leere Zeichenfolge, wenn keine vorhanden ist.

resourceType

string

Der Ressourcentypname. Der Typname einer Web-App ist z. B. "Websites" (von Microsoft.Web/Sites).

resourceName

string

Der Name der Ressource.

options
PolicyAssignmentsListForResourceOptionalParams

Die Optionsparameter.

Gibt zurück

listForResourceGroup(string, PolicyAssignmentsListForResourceGroupOptionalParams)

Dieser Vorgang ruft die Liste aller Richtlinienzuordnungen ab, die der angegebenen Ressourcengruppe im angegebenen Abonnement zugeordnet sind, die mit dem optionalen $filter übereinstimmen. Gültige Werte für $filter sind: 'atScope()', 'atExactScope()' oder 'policyDefinitionId eq '{value}'. Wenn $filter nicht angegeben wird, enthält die nicht gefilterte Liste alle richtlinienzuordnungen, die der Ressourcengruppe zugeordnet sind, einschließlich derjenigen, die direkt angewendet oder aus den enthaltenden Bereichen angewendet werden, sowie alle angewendeten Ressourcen, die in der Ressourcengruppe enthalten sind. Wenn $filter=atScope() angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen, die für die Ressourcengruppe gelten, was alles in der nicht gefilterten Liste ist, mit Ausnahme derjenigen, die auf Ressourcen in der Ressourcengruppe angewendet wurden. Wenn $filter=atExactScope() bereitgestellt wird, enthält die zurückgegebene Liste nur alle Richtlinienzuordnungen, die sich in der Ressourcengruppe befinden. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuordnungen der Richtliniendefinition, deren ID {value} ist, die für die Ressourcengruppe gelten.

function listForResourceGroup(resourceGroupName: string, options?: PolicyAssignmentsListForResourceGroupOptionalParams): PagedAsyncIterableIterator<PolicyAssignment, PolicyAssignment[], PageSettings>

Parameter

resourceGroupName

string

Der Name der Ressourcengruppe, die Richtlinienzuweisungen enthält.

Gibt zurück

update(string, string, PolicyAssignmentUpdate, PolicyAssignmentsUpdateOptionalParams)

Dieser Vorgang aktualisiert eine Richtlinienzuweisung mit dem angegebenen Bereich und Namen. Richtlinienzuweisungen gelten für alle Ressourcen, die in ihrem Bereich enthalten sind. Wenn Sie beispielsweise eine Richtlinie im Ressourcengruppenbereich zuweisen, gilt diese Richtlinie für alle Ressourcen in der Gruppe.

function update(scope: string, policyAssignmentName: string, parameters: PolicyAssignmentUpdate, options?: PolicyAssignmentsUpdateOptionalParams): Promise<PolicyAssignment>

Parameter

scope

string

Der Bereich der Richtlinienzuweisung. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

policyAssignmentName

string

Der Name der Richtlinienzuweisung.

parameters
PolicyAssignmentUpdate

Parameter für die Patchanforderung für die Richtlinienzuweisung.

options
PolicyAssignmentsUpdateOptionalParams

Die Optionsparameter.

Gibt zurück

Promise<PolicyAssignment>

updateById(string, PolicyAssignmentUpdate, PolicyAssignmentsUpdateByIdOptionalParams)

Dieser Vorgang aktualisiert die Richtlinienzuweisung mit der angegebenen ID. Richtlinienzuweisungen, die in einem Bereich vorgenommen werden, gelten für alle Ressourcen, die in diesem Bereich enthalten sind. Wenn Sie beispielsweise einer Ressourcengruppe eine Richtlinie zuweisen, gilt diese Richtlinie für alle Ressourcen in der Gruppe. Richtlinienzuweisungs-IDs weisen dieses Format auf: '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'.

function updateById(policyAssignmentId: string, parameters: PolicyAssignmentUpdate, options?: PolicyAssignmentsUpdateByIdOptionalParams): Promise<PolicyAssignment>

Parameter

policyAssignmentId

string

Die ID der zu aktualisierenden Richtlinienzuweisung. Verwenden Sie das Format "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

parameters
PolicyAssignmentUpdate

Parameter für die Patchanforderung für die Richtlinienzuweisung.

options
PolicyAssignmentsUpdateByIdOptionalParams

Die Optionsparameter.

Gibt zurück

Promise<PolicyAssignment>