Role Assignments - Delete

Ta bort en rolltilldelning efter omfång och namn.

DELETE https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=2022-04-01
DELETE https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=2022-04-01&tenantId={tenantId}

URI-parametrar

Name I Obligatorisk Typ Description
roleAssignmentName
path True

string

Namnet på rolltilldelningen. Det kan vara valfritt giltigt GUID.

scope
path True

string

Åtgärdens eller resursens omfattning. Giltiga omfång är: prenumeration (format: '/subscriptions/{subscriptionId}'), resursgrupp (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' eller resurs (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

api-version
query True

string

Den API-version som ska användas för den här åtgärden.

tenantId
query

string

Klientorganisations-ID för begäran mellan klientorganisationer

Svar

Name Typ Description
200 OK

RoleAssignment

Returnerar den borttagna rolltilldelningen.

204 No Content

Rolltilldelningen har redan tagits bort eller finns inte.

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Behörigheter

För att anropa detta API måste du ha tilldelats en roll som har följande behörigheter. Mer information finns i Inbyggda roller i Azure.

Microsoft.Authorization/roleAssignments/delete

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Delete role assignment

Exempelbegäran

DELETE https://management.azure.com/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747?api-version=2022-04-01

Exempelsvar

{
  "properties": {
    "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
    "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
    "principalType": "User",
    "scope": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2"
  },
  "id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "b0f43c54-e787-4862-89b1-a653fa9cf747"
}

Definitioner

Name Description
ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

PrincipalType

Huvudtypen för det tilldelade huvudnamns-ID:t.

RoleAssignment

Rolltilldelningar

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

PrincipalType

Huvudtypen för det tilldelade huvudnamns-ID:t.

Name Typ Description
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RoleAssignment

Rolltilldelningar

Name Typ Standardvärde Description
id

string

Rolltilldelnings-ID.

name

string

Rolltilldelningens namn.

properties.condition

string

Villkoren för rolltilldelningen. Detta begränsar de resurser som den kan tilldelas till. t.ex. @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase "foo_storage_container"

properties.conditionVersion

string

Version av villkoret. För närvarande är det enda accepterade värdet "2.0"

properties.createdBy

string

ID för användaren som skapade tilldelningen

properties.createdOn

string

Tiden då den skapades

properties.delegatedManagedIdentityResourceId

string

ID för den delegerade hanterade identitetsresursen

properties.description

string

Beskrivning av rolltilldelning

properties.principalId

string

Huvud-ID:t.

properties.principalType

PrincipalType

User

Huvudtypen för det tilldelade huvudnamns-ID:t.

properties.roleDefinitionId

string

Rolldefinitions-ID.

properties.scope

string

Rolltilldelningsomfånget.

properties.updatedBy

string

ID för användaren som uppdaterade tilldelningen

properties.updatedOn

string

Tidpunkt då den uppdaterades

type

string

Rolltilldelningstypen.