Policy Assignments - Delete

Reference

Service:: Policy

API Version:: 2023-04-01

Tato operace odstraní přiřazení zásady s názvem a oborem, ve které bylo vytvořeno. Obor přiřazení zásad je část id před /providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}.

DELETE https://management.azure.com/{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}?api-version=2023-04-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description

Name	V	Vyžadováno	Typ	Description
policyAssignmentName	path	True	string	Název přiřazení zásad, které se má odstranit. Regex pattern: `^[^<>%&:\?.+/][^<>*%&:\?.+/ ]+$`
scope	path	True	string	Rozsah přiřazení zásad. Platné obory jsou: skupina pro správu (formát: /providers/Microsoft.Management/managementGroups/{managementGroup}), předplatné (formát: /subscriptions/{subscriptionId}), skupina prostředků (formát: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}). nebo prostředek (formát: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

policyAssignmentName

path

True

string

Název přiřazení zásad, které se má odstranit.

Regex pattern: ^[^<>*%&:\?.+/]*[^<>*%&:\?.+/ ]+$

scope

path

True

string

Rozsah přiřazení zásad. Platné obory jsou: skupina pro správu (formát: /providers/Microsoft.Management/managementGroups/{managementGroup}), předplatné (formát: /subscriptions/{subscriptionId}), skupina prostředků (formát: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}). nebo prostředek (formát: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

api-version

query

True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	PolicyAssignment	OK – vrátí informace o odstraněné přiřazení.
204 No Content		Žádný obsah – přiřazení zásad neexistuje.
Other Status Codes	CloudError	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Delete a policy assignment

Sample Request

HTTP

DELETE https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/EnforceNaming?api-version=2023-04-01

Sample Response

Status code:: 200

{
  "properties": {
    "displayName": "Enforce resource naming rules",
    "description": "Force resource names to begin with given DeptA and end with -LC",
    "metadata": {
      "assignedBy": "Special Someone"
    },
    "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
    "notScopes": [],
    "parameters": {
      "prefix": {
        "value": "DeptA"
      },
      "suffix": {
        "value": "-LC"
      }
    },
    "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2"
  },
  "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/EnforceNaming",
  "type": "Microsoft.Authorization/policyAssignments",
  "name": "EnforceNaming"
}

Status code:: 204

Definice

Name	Description
CloudError	Chybová odpověď z operace zásad.
createdByType	Typ identity, která vytvořila prostředek.
enforcementMode	Režim vynucení přiřazení zásad Možné hodnoty jsou Default a DoNotEnforce.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorResponse	Odpověď na chybu
Identity	Identita prostředku. Přiřazení zásad podporují maximálně jednu identitu. To je buď identita přiřazená systémem, nebo identita přiřazená jedním uživatelem.
NonComplianceMessage	Zpráva, která popisuje, proč prostředek nevyhovuje zásadám. To se zobrazuje v chybových zprávách zamítnutí a ve výsledcích nedodržování předpisů u prostředku.
Override	Hodnota vlastnosti zásady se přepíše.
OverrideKind	Druh přepsání.
ParameterValuesValue	Hodnota parametru.
PolicyAssignment	Přiřazení zásad.
ResourceIdentityType	Typ identity. Toto je jediné povinné pole při přidávání identity přiřazené systémem nebo uživatelem k prostředku.
ResourceSelector	Selektor prostředků pro filtrování zásad podle vlastností prostředku.
Selector	Výraz selektoru
SelectorKind	Druh voliče.
systemData	Metadata týkající se vytvoření a poslední změny prostředku
UserAssignedIdentities	Identita uživatele přidružená k zásadám. Odkazy na klíče slovníku identit uživatelů budou ID prostředků ARM ve formátu :/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

CloudError

Chybová odpověď z operace zásad.

Name	Typ	Description
error	ErrorResponse	Odpověď na chybu Běžná odpověď na chybu pro všechna rozhraní API azure Resource Manager, která vrací podrobnosti o chybě pro neúspěšné operace. (To také odpovídá formátu odpovědi na chybu OData.)

createdByType

Typ identity, která vytvořila prostředek.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

enforcementMode

Režim vynucení přiřazení zásad Možné hodnoty jsou Default a DoNotEnforce.

Name	Typ	Description
Default	string	Účinek zásad se vynucuje během vytváření nebo aktualizace prostředku.
DoNotEnforce	string	Efekt zásad se nevynucuje při vytváření nebo aktualizaci prostředku.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorResponse

Odpověď na chybu

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě
code	string	Kód chyby
details	ErrorResponse[]	Podrobnosti o chybě
message	string	Chybová zpráva
target	string	Cíl chyby.

Identity

Identita prostředku. Přiřazení zásad podporují maximálně jednu identitu. To je buď identita přiřazená systémem, nebo identita přiřazená jedním uživatelem.

Name	Typ	Description
principalId	string	ID objektu zabezpečení identity prostředku. Tato vlastnost bude k dispozici pouze pro identitu přiřazenou systémem.
tenantId	string	ID tenanta identity prostředku. Tato vlastnost bude k dispozici pouze pro identitu přiřazenou systémem.
type	ResourceIdentityType	Typ identity. Toto je jediné povinné pole při přidávání identity přiřazené systémem nebo uživatelem k prostředku.
userAssignedIdentities	UserAssignedIdentities	Identita uživatele přidružená k zásadám. Odkazy na klíče slovníku identit uživatelů budou ID prostředků ARM ve formátu :/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

NonComplianceMessage

Zpráva, která popisuje, proč prostředek nevyhovuje zásadám. To se zobrazuje v chybových zprávách zamítnutí a ve výsledcích nedodržování předpisů u prostředku.

Name	Typ	Description
message	string	Zpráva, která popisuje, proč prostředek nevyhovuje zásadám. To se zobrazuje v chybových zprávách zamítnutí a ve výsledcích nedodržování předpisů u prostředku.
policyDefinitionReferenceId	string	Referenční ID definice zásad v definici sady zásad, pro kterou je zpráva určená. To platí jenom v případě, že přiřazení zásad přiřadí definici sady zásad. Pokud tato možnost není zadána, zpráva se vztahuje na všechny zásady přiřazené tímto přiřazením zásad.

Override

Hodnota vlastnosti zásady se přepíše.

Name	Typ	Description
kind	OverrideKind	Druh přepsání.
selectors	Selector[]	Seznam výrazů selektoru.
value	string	Hodnota, která má přepsat vlastnost zásady.

OverrideKind

Druh přepsání.

Name	Typ	Description
policyEffect	string	Přepíše typ efektu zásad.

ParameterValuesValue

Hodnota parametru.

Name	Typ	Description
value	object	Hodnota parametru.