PolicyAssignments interface

此作業會建立或更新具有指定範圍和名稱的原則指派。 原則指派會套用至其範圍內所包含的所有資源。 例如，當您在資源群組範圍指派原則時，該原則會套用至群組中的所有資源。

此作業會使用指定的識別碼建立或更新原則指派。 在範圍上所做的原則指派會套用至該範圍中包含的所有資源。 例如，當您將原則指派給套用至群組中所有資源的資源群組時。 原則指派識別碼的格式如下：'{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'。 有效的範圍包括：管理群組 (格式：'/providers/Microsoft.Management/managementGroups/{managementGroup}') ， 訂用帳戶 (格式：'/subscriptions/{subscriptionId}') 、資源群組 (格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'，或資源 (格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'。

此作業會刪除原則指派，並指定其名稱及其建立範圍。 原則指派的範圍是其識別碼在 '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}' 之前的一部分。

此作業會刪除具有指定識別碼的原則。 原則指派識別碼的格式如下：'{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'。 {scope} 的有效格式為：'/providers/Microsoft.Management/managementGroups/{managementGroup}' (管理群組) ，'/subscriptions/{subscriptionId}' (訂閱) ， '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' (資源群組) ，或 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}' (資源) 。

此作業會擷取單一原則指派，並指定其名稱及其建立所在的範圍。

作業會擷取具有指定識別碼的原則指派。 原則指派識別碼的格式如下：'{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'。 有效的範圍包括：管理群組 (格式：'/providers/Microsoft.Management/managementGroups/{managementGroup}') ， 訂用帳戶 (格式：'/subscriptions/{subscriptionId}') 、資源群組 (格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'，或資源 (格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'。

這項作業會擷取與指定訂用帳戶相關聯的所有原則指派清單，這些指派符合選擇性指定$filter。 $filter的有效值為：'atScope () '、'atExactScope () ' 或 'policyDefinitionId eq '{value}''。 如果未提供$filter，未篩選清單會包含與訂用帳戶相關聯的所有原則指派，包括直接套用或套用自包含指定訂用帳戶的管理群組，以及套用至包含在訂用帳戶內之物件的任何原則指派。 如果提供 $filter=atScope () ，則傳回的清單會包含套用至訂用帳戶的所有原則指派，這是未篩選清單中的所有內容，但套用至訂用帳戶內包含的物件除外。 如果提供 $filter=atExactScope () ，傳回的清單只會包含訂用帳戶上的所有原則指派。 如果提供 $filter=policyDefinitionId eq '{value}'，傳回的清單會包含識別碼為 {value} 的原則定義的所有原則指派。

這項作業會擷取適用于所有符合指定$filter之管理群組的原則指派清單。 $filter的有效值為：'atScope () '、'atExactScope () ' 或 'policyDefinitionId eq '{value}''。 如果提供 $filter=atScope () ，傳回的清單會包含指派給管理群組或管理群組上階的所有原則指派。 如果提供 $filter=atExactScope () ，傳回的清單只會包含管理群組中的所有原則指派。 如果提供 $filter=policyDefinitionId eq '{value}'，傳回的清單會包含套用至管理群組的原則定義識別碼為 {value} 的所有原則指派。

此作業會擷取與指定資源群組和訂用帳戶中指定資源相關聯的所有原則指派清單，這些指派符合選擇性指定$filter。 $filter的有效值為：'atScope () '、'atExactScope () ' 或 'policyDefinitionId eq '{value}''。 如果未提供$filter，未篩選清單會包含與資源相關聯的所有原則指派，包括直接套用或套用自所有包含範圍的原則指派，以及套用至資源內含資源內含的任何原則指派。 如果提供 $filter=atScope () ，則傳回的清單會包含套用至資源的所有原則指派，這是未篩選清單中所有專案，但套用至資源內含資源的資源除外。 如果提供 $filter=atExactScope () ，傳回的清單只會包含資源層級的所有原則指派。 如果提供 $filter=policyDefinitionId eq '{value}'，傳回的清單會包含套用至資源的原則定義識別碼為 {value} 的所有原則指派。 三個參數加上資源名稱可用來識別特定資源。 如果資源不是父資源的一部分， (較常見的案例) ，則不應該 (提供父資源路徑，或提供為 '') 。 例如，Web 應用程式可以指定為 ({resourceProviderNamespace} == 'Microsoft.Web'， {parentResourcePath} == ''， {resourceType} == 'sites'， {resourceName} == 'MyWebApp') 。 如果資源是父資源的一部分，則應該提供所有參數。 例如，可以將虛擬機器 DNS 名稱指定為 ({resourceProviderNamespace} == 'Microsoft.Compute'， {parentResourcePath} == 'virtualMachines/MyVirtualMachine'， {resourceType} == 'domainNames'， {resourceName} == 'MyComputerName') 。 另外提供命名空間和類型名稱的便利替代方法是以 {resourceType} 參數格式提供兩者： ({resourceProviderNamespace} == ''， {parentResourcePath} == '' ， {resourceType} == 'Microsoft.Web/sites'， {resourceName} == 'MyWebApp') 。

此作業會擷取指定訂用帳戶中與指定資源群組相關聯的所有原則指派清單，此清單符合選擇性的指定$filter。 $filter的有效值為：'atScope () '、'atExactScope () ' 或 'policyDefinitionId eq '{value}''。 如果未提供$filter，未篩選清單會包含與資源群組相關聯的所有原則指派，包括直接套用或套用自包含範圍的指派，以及套用至資源群組內所含資源的任何原則指派。 如果提供 $filter=atScope () ，則傳回的清單會包含套用至資源群組的所有原則指派，這是未篩選清單中所有專案，但套用至資源群組內所含資源以外的所有原則指派。 如果提供 $filter=atExactScope () ，傳回的清單只會包含資源群組的所有原則指派。 如果提供 $filter=policyDefinitionId eq '{value}'，傳回的清單會包含套用至資源群組的原則定義識別碼為 {value} 的所有原則指派。

這項作業會以指定的範圍和名稱更新原則指派。 原則指派會套用至其範圍內所包含的所有資源。 例如，當您在資源群組範圍指派原則時，該原則會套用至群組中的所有資源。

這項作業會以指定的識別碼更新原則指派。 在範圍上所做的原則指派會套用至該範圍中包含的所有資源。 例如，當您將原則指派給套用至群組中所有資源的資源群組時。 原則指派識別碼的格式如下：'{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'。 有效的範圍包括：管理群組 (格式：'/providers/Microsoft.Management/managementGroups/{managementGroup}') ， 訂用帳戶 (格式：'/subscriptions/{subscriptionId}') 、資源群組 (格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'，或資源 (格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'。