Management Locks - Create Or Update At Resource Group Level

Erstellt oder aktualisiert eine Verwaltungssperre auf Ressourcengruppenebene.
Wenn Sie eine Sperre in einem übergeordneten Bereich anwenden, erben alle untergeordneten Ressourcen diese Sperre. Zum Erstellen von Verwaltungssperren müssen Sie Zugriff auf Microsoft.Authorization/*- oder Microsoft.Authorization/locks/*-Aktionen haben. Unter den integrierten Rollen verfügen nur „Besitzer“ und „Benutzerzugriffsadministrator“ über diese Aktionen.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/locks/{lockName}?api-version=2016-09-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
lockName
path True

string

Der Sperrname. Der Sperrname darf maximal 260 Zeichen lang sein. Sie darf keine Steuerzeichen > enthalten<, %, &, :, , ? oder /.

resourceGroupName
path True

string

Der Name der zu sperrenden Ressourcengruppe.

RegEx-Muster: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

Die API-Version, die für den Vorgang verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.level True

LockLevel

Die Ebene der Sperre. Mögliche Werte sind: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete bedeutet, dass autorisierte Benutzer in der Lage sind, die Ressourcen zu lesen und zu ändern, aber nicht zu löschen. ReadOnly bedeutet, dass autorisierte Benutzer nur aus einer Ressource lesen, aber nicht ändern oder löschen können.

properties.notes

string

Hinweise zur Sperre. Maximal 512 Zeichen.

properties.owners

ManagementLockOwner[]

Die Besitzer der Sperre.

Antworten

Name Typ Beschreibung
200 OK

ManagementLockObject

OK: Gibt Informationen zur Sperre zurück.

201 Created

ManagementLockObject

Erstellt: Gibt Informationen zur Sperre zurück.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Create management lock at resource group level

Beispielanforderung

PUT https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourcegroupname/providers/Microsoft.Authorization/locks/testlock?api-version=2016-09-01

{
  "properties": {
    "level": "ReadOnly"
  }
}

Beispiel für eine Antwort

{
  "properties": {
    "level": "ReadOnly"
  },
  "id": "/providers/Microsoft.Authorization/locks/testlock",
  "type": "Microsoft.Authorization/locks",
  "name": "testlock"
}
{
  "properties": {
    "level": "ReadOnly"
  },
  "id": "/providers/Microsoft.Authorization/locks/testlock",
  "type": "Microsoft.Authorization/locks",
  "name": "testlock"
}

Definitionen

Name Beschreibung
LockLevel

Die Ebene der Sperre. Mögliche Werte sind: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete bedeutet, dass autorisierte Benutzer in der Lage sind, die Ressourcen zu lesen und zu ändern, aber nicht zu löschen. ReadOnly bedeutet, dass autorisierte Benutzer nur aus einer Ressource lesen, aber nicht ändern oder löschen können.

ManagementLockObject

Die Sperrinformationen.

ManagementLockOwner

Eigenschaften des Besitzers sperren.

LockLevel

Die Ebene der Sperre. Mögliche Werte sind: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete bedeutet, dass autorisierte Benutzer in der Lage sind, die Ressourcen zu lesen und zu ändern, aber nicht zu löschen. ReadOnly bedeutet, dass autorisierte Benutzer nur aus einer Ressource lesen, aber nicht ändern oder löschen können.

Name Typ Beschreibung
CanNotDelete

string

NotSpecified

string

ReadOnly

string

ManagementLockObject

Die Sperrinformationen.

Name Typ Beschreibung
id

string

Die Ressourcen-ID der Sperre.

name

string

Der Name der Sperre.

properties.level

LockLevel

Die Ebene der Sperre. Mögliche Werte sind: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete bedeutet, dass autorisierte Benutzer in der Lage sind, die Ressourcen zu lesen und zu ändern, aber nicht zu löschen. ReadOnly bedeutet, dass autorisierte Benutzer nur aus einer Ressource lesen, aber nicht ändern oder löschen können.

properties.notes

string

Hinweise zur Sperre. Maximal 512 Zeichen.

properties.owners

ManagementLockOwner[]

Die Besitzer der Sperre.

type

string

Der Ressourcentyp der Sperre: Microsoft.Authorization/locks.

ManagementLockOwner

Eigenschaften des Besitzers sperren.

Name Typ Beschreibung
applicationId

string

Die Anwendungs-ID des Sperrbesitzers.