Freigeben über


PolicyAssignments interface

Schnittstelle, die eine PolicyAssignments darstellt.

Methoden

create(string, string, PolicyAssignment, PolicyAssignmentsCreateOptionalParams)

Mit diesem Vorgang wird eine Richtlinienzuweisung mit dem angegebenen Bereich und Namen erstellt oder aktualisiert. 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)

Mit diesem Vorgang wird die Richtlinienzuweisung mit der angegebenen ID erstellt oder aktualisiert. Richtlinienzuweisungen, die für einen 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 das folgende 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 unter Angabe ihres Namens und des Bereichs, in dem sie erstellt wurde. Der Bereich einer Richtlinienzuweisung ist der Teil ihrer ID, die "/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}" vorangeht.

deleteById(string, PolicyAssignmentsDeleteByIdOptionalParams)

Dieser Vorgang löscht die Richtlinie mit der angegebenen ID. Richtlinienzuweisungs-IDs weisen das folgende 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 unter Angabe ihres Namens und des Bereichs ab, in dem sie erstellt wurde.

getById(string, PolicyAssignmentsGetByIdOptionalParams)

Der Vorgang ruft die Richtlinienzuweisung mit der angegebenen ID ab. Richtlinienzuweisungs-IDs weisen das folgende 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 und der optional angegebenen $filter entsprechen. Gültige Werte für $filter sind: "atScope()", "atExactScope()" oder "policyDefinitionId eq "{value}". Wenn $filter nicht bereitgestellt wird, enthält die ungefilterte Liste alle Richtlinienzuweisungen, die dem Abonnement zugeordnet sind, einschließlich derjenigen, die direkt oder aus Verwaltungsgruppen gelten, die das angegebene Abonnement enthalten, sowie alle, die auf Objekte im Abonnement angewendet werden. Wenn $filter=atScope() angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen, die für das Abonnement gelten. Dies ist alles in der ungefilterten Liste mit Ausnahme derjenigen, die auf Objekte angewendet werden, die im Abonnement enthalten sind. Wenn $filter=atExactScope() angegeben wird, enthält die zurückgegebene Liste nur alle Richtlinienzuweisungen im Abonnement. Wenn $filter=policyDefinitionId eq '{value}' angegeben 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 der Verwaltungsgruppe. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID {value} lautet, die für die Verwaltungsgruppe gelten.

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

Dieser Vorgang ruft die Liste aller Richtlinienzuweisungen ab, die der angegebenen Ressource in der angegebenen Ressourcengruppe und dem angegebenen Abonnement zugeordnet sind und der optionalen $filter entsprechen. Gültige Werte für $filter sind: "atScope()", "atExactScope()" oder "policyDefinitionId eq "{value}". Wenn $filter nicht bereitgestellt wird, enthält die ungefilterte Liste alle der Ressource zugeordneten Richtlinienzuweisungen, einschließlich derjenigen, die direkt oder aus allen enthaltenden Bereichen gelten, sowie alle, die auf ressourcenbezogene Ressourcen angewendet werden, 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. Dies ist alles in der ungefilterten Liste mit Ausnahme der in der Ressource enthaltenen Ressourcen. Wenn $filter=atExactScope() angegeben wird, enthält die zurückgegebene Liste nur alle Richtlinienzuweisungen auf Ressourcenebene. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID {value} lautet, die für die Ressource gelten. Drei Parameter und 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 angegeben (oder als "" angegeben werden). 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 angegeben werden. Ein DNS-Name eines virtuellen Computers kann beispielsweise als ({resourceProviderNamespace} == 'Microsoft.Compute', {parentResourcePath} == 'virtualMachines/MyVirtualMachine', {resourceType} == 'domainNames', {resourceName} == 'MyComputerName') angegeben werden. Eine praktische Alternative zum getrennten Bereitstellen des Namespace und des Typnamens besteht darin, beide im {resourceType}-Parameter im Format anzugeben: ({resourceProviderNamespace} == '', {parentResourcePath} == '', {resourceType} == 'Microsoft.Web/sites', {resourceName} == 'MyWebApp').

listForResourceGroup(string, PolicyAssignmentsListForResourceGroupOptionalParams)

Dieser Vorgang ruft die Liste aller Richtlinienzuweisungen ab, die der angegebenen Ressourcengruppe im angegebenen Abonnement zugeordnet sind und der optional angegebenen $filter entsprechen. Gültige Werte für $filter sind: "atScope()", "atExactScope()" oder "policyDefinitionId eq "{value}". Wenn $filter nicht angegeben wird, enthält die ungefilterte Liste alle richtlinienbezogenen Zuweisungen, die der Ressourcengruppe zugeordnet sind, einschließlich derjenigen, die direkt gelten oder über Bereiche gelten, sowie alle, die auf ressourcenbezogene Ressourcen angewendet werden, 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. Dies ist alles in der ungefilterten Liste mit Ausnahme der in der Ressourcengruppe enthaltenen Ressourcen. Wenn $filter=atExactScope() angegeben wird, enthält die zurückgegebene Liste nur alle Richtlinienzuweisungen in der Ressourcengruppe. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID {value} lautet, 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)

Bei diesem Vorgang wird die Richtlinienzuweisung mit der angegebenen ID aktualisiert. Richtlinienzuweisungen, die für einen 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 das folgende 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)

Mit diesem Vorgang wird eine Richtlinienzuweisung mit dem angegebenen Bereich und Namen erstellt oder aktualisiert. 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)

Mit diesem Vorgang wird die Richtlinienzuweisung mit der angegebenen ID erstellt oder aktualisiert. Richtlinienzuweisungen, die für einen 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 das folgende 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 unter Angabe ihres Namens und des Bereichs, in dem sie erstellt wurde. Der Bereich einer Richtlinienzuweisung ist der Teil ihrer ID, die "/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}" vorangeht.

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 das folgende 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 unter Angabe ihres Namens und des Bereichs ab, in dem sie 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 das folgende 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 und der optional angegebenen $filter entsprechen. Gültige Werte für $filter sind: "atScope()", "atExactScope()" oder "policyDefinitionId eq "{value}". Wenn $filter nicht bereitgestellt wird, enthält die ungefilterte Liste alle Richtlinienzuweisungen, die dem Abonnement zugeordnet sind, einschließlich derjenigen, die direkt oder aus Verwaltungsgruppen gelten, die das angegebene Abonnement enthalten, sowie alle, die auf Objekte im Abonnement angewendet werden. Wenn $filter=atScope() angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen, die für das Abonnement gelten. Dies ist alles in der ungefilterten Liste mit Ausnahme derjenigen, die auf Objekte angewendet werden, die im Abonnement enthalten sind. Wenn $filter=atExactScope() angegeben wird, enthält die zurückgegebene Liste nur alle Richtlinienzuweisungen im Abonnement. Wenn $filter=policyDefinitionId eq '{value}' angegeben 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 der Verwaltungsgruppe. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID {value} lautet, die für die Verwaltungsgruppe gelten.

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)

Dieser Vorgang ruft die Liste aller Richtlinienzuweisungen ab, die der angegebenen Ressource in der angegebenen Ressourcengruppe und dem angegebenen Abonnement zugeordnet sind und der optionalen $filter entsprechen. Gültige Werte für $filter sind: "atScope()", "atExactScope()" oder "policyDefinitionId eq "{value}". Wenn $filter nicht bereitgestellt wird, enthält die ungefilterte Liste alle der Ressource zugeordneten Richtlinienzuweisungen, einschließlich derjenigen, die direkt oder aus allen enthaltenden Bereichen gelten, sowie alle, die auf ressourcenbezogene Ressourcen angewendet werden, 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. Dies ist alles in der ungefilterten Liste mit Ausnahme der in der Ressource enthaltenen Ressourcen. Wenn $filter=atExactScope() angegeben wird, enthält die zurückgegebene Liste nur alle Richtlinienzuweisungen auf Ressourcenebene. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID {value} lautet, die für die Ressource gelten. Drei Parameter und 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 angegeben (oder als "" angegeben werden). 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 angegeben werden. Ein DNS-Name eines virtuellen Computers kann beispielsweise als ({resourceProviderNamespace} == 'Microsoft.Compute', {parentResourcePath} == 'virtualMachines/MyVirtualMachine', {resourceType} == 'domainNames', {resourceName} == 'MyComputerName') angegeben werden. Eine praktische Alternative zum getrennten Bereitstellen des Namespace und des Typnamens besteht darin, beide im {resourceType}-Parameter im Format anzugeben: ({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. Der Namespace eines virtuellen Computers ist beispielsweise 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 lautet beispielsweise "Sites" (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 Richtlinienzuweisungen ab, die der angegebenen Ressourcengruppe im angegebenen Abonnement zugeordnet sind und der optional angegebenen $filter entsprechen. Gültige Werte für $filter sind: "atScope()", "atExactScope()" oder "policyDefinitionId eq "{value}". Wenn $filter nicht angegeben wird, enthält die ungefilterte Liste alle richtlinienbezogenen Zuweisungen, die der Ressourcengruppe zugeordnet sind, einschließlich derjenigen, die direkt gelten oder über Bereiche gelten, sowie alle, die auf ressourcenbezogene Ressourcen angewendet werden, 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. Dies ist alles in der ungefilterten Liste mit Ausnahme der in der Ressourcengruppe enthaltenen Ressourcen. Wenn $filter=atExactScope() angegeben wird, enthält die zurückgegebene Liste nur alle Richtlinienzuweisungen in der Ressourcengruppe. Wenn $filter=policyDefinitionId eq '{value}' angegeben wird, enthält die zurückgegebene Liste alle Richtlinienzuweisungen der Richtliniendefinition, deren ID {value} lautet, 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)

Bei diesem Vorgang wird die Richtlinienzuweisung mit der angegebenen ID aktualisiert. Richtlinienzuweisungen, die für einen 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 das folgende 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>