Management Locks - Create Or Update At Resource Level

Hizmet:

Resource Management

API Sürümü:

2016-09-01

Kaynak düzeyinde veya kaynağın altındaki herhangi bir düzeyde bir yönetim kilidi oluşturur veya güncelleştirir.
Üst kapsamda bir kilit uyguladığınızda, tüm alt kaynaklar aynı kilidi devralır. Yönetim kilitleri oluşturmak için Microsoft.Authorization/* veya Microsoft.Authorization/locks/* eylemlerine erişiminiz olmalıdır. Yerleşik rollerden yalnızca Sahip ve Kullanııcı Erişiimi Yöneticisi bu eylemleri kullanabilir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
lockName	path	True	string	Kilidin adı. Kilit adı en fazla 260 karakter olabilir. , > %, &, :, , ?, / veya herhangi bir denetim karakteri içeremez<.
parentResourcePath	path	True	string	Üst kaynak kimliği.
resourceGroupName	path	True	string	Kilitlenmesi gereken kaynağı içeren kaynak grubunun adı. Normal ifade deseni: ^[-\w\._\(\)]+$
resourceName	path	True	string	Kilitlenecek kaynağın adı.
resourceProviderNamespace	path	True	string	Kilit kaynağın kaynak sağlayıcısı ad alanı.
resourceType	path	True	string	Kilit kaynağın kaynak türü.
subscriptionId	path	True	string	Hedef aboneliğin kimliği.
api-version	query	True	string	İşlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
properties.level	True	LockLevel	Kilidin seviyesi. Olası değerler şunlardır: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete, yetkili kullanıcıların kaynakları okuyup değiştirebileceği ancak silemeyeceği anlamına gelir. ReadOnly, yetkili kullanıcıların yalnızca bir kaynaktan okuyabileceği, ancak kaynağı değiştiremeyecekleri veya silebilecekleri anlamına gelir.
properties.notes		string	Kilitle ilgili notlar. En fazla 512 karakter.
properties.owners		ManagementLockOwner[]	Kilidin sahipleri.

Yanıtlar

Name	Tür	Description
200 OK	ManagementLockObject	Tamam - Kilit hakkındaki bilgileri döndürür.
201 Created	ManagementLockObject	Oluşturuldu - Kilit hakkındaki bilgileri döndürür.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Create management lock at resource level

Örnek isteği

HTTP

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

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.resources.fluent.models.ManagementLockObjectInner;
import com.azure.resourcemanager.resources.models.LockLevel;

/** Samples for ManagementLocks CreateOrUpdateAtResourceLevel. */
public final class Main {
    /*
     * x-ms-original-file: specification/resources/resource-manager/Microsoft.Authorization/stable/2016-09-01/examples/ManagementLocks_CreateOrUpdateAtResourceLevel.json
     */
    /**
     * Sample code: Create management lock at resource level.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createManagementLockAtResourceLevel(com.azure.resourcemanager.AzureResourceManager azure) {
        azure
            .genericResources()
            .manager()
            .managementLockClient()
            .getManagementLocks()
            .createOrUpdateAtResourceLevelWithResponse(
                "resourcegroupname",
                "Microsoft.Storage",
                "parentResourcePath",
                "storageAccounts",
                "teststorageaccount",
                "testlock",
                new ManagementLockObjectInner().withLevel(LockLevel.READ_ONLY),
                Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource import ManagementLockClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource
# USAGE
    python management_locks_create_or_update_at_resource_level.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ManagementLockClient(
        credential=DefaultAzureCredential(),
        subscription_id="subscriptionId",
    )

    response = client.management_locks.create_or_update_at_resource_level(
        resource_group_name="resourcegroupname",
        resource_provider_namespace="Microsoft.Storage",
        parent_resource_path="parentResourcePath",
        resource_type="storageAccounts",
        resource_name="teststorageaccount",
        lock_name="testlock",
        parameters={"properties": {"level": "ReadOnly"}},
    )
    print(response)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Authorization/stable/2016-09-01/examples/ManagementLocks_CreateOrUpdateAtResourceLevel.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ManagementLockClient } = require("@azure/arm-locks-profile-2020-09-01-hybrid");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to When you apply a lock at a parent scope, all child resources inherit the same lock. To create management locks, you must have access to Microsoft.Authorization/* or Microsoft.Authorization/locks/* actions. Of the built-in roles, only Owner and User Access Administrator are granted those actions.
 *
 * @summary When you apply a lock at a parent scope, all child resources inherit the same lock. To create management locks, you must have access to Microsoft.Authorization/* or Microsoft.Authorization/locks/* actions. Of the built-in roles, only Owner and User Access Administrator are granted those actions.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Authorization/stable/2016-09-01/examples/ManagementLocks_CreateOrUpdateAtResourceLevel.json
 */
async function createManagementLockAtResourceLevel() {
  const subscriptionId = process.env["LOCKS_SUBSCRIPTION_ID"] || "subscriptionId";
  const resourceGroupName = process.env["LOCKS_RESOURCE_GROUP"] || "resourcegroupname";
  const resourceProviderNamespace = "Microsoft.Storage";
  const parentResourcePath = "parentResourcePath";
  const resourceType = "storageAccounts";
  const resourceName = "teststorageaccount";
  const lockName = "testlock";
  const parameters = { level: "ReadOnly" };
  const credential = new DefaultAzureCredential();
  const client = new ManagementLockClient(credential, subscriptionId);
  const result = await client.managementLocks.createOrUpdateAtResourceLevel(
    resourceGroupName,
    resourceProviderNamespace,
    parentResourcePath,
    resourceType,
    resourceName,
    lockName,
    parameters
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Örnek yanıt

Durum kodu:

201

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

Durum kodu:

200

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

Tanımlar

Name	Description
LockLevel	Kilidin seviyesi. Olası değerler şunlardır: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete, yetkili kullanıcıların kaynakları okuyup değiştirebileceği ancak silemeyeceği anlamına gelir. ReadOnly, yetkili kullanıcıların yalnızca bir kaynaktan okuyabileceği, ancak kaynağı değiştiremeyecekleri veya silebilecekleri anlamına gelir.
ManagementLockObject	Kilit bilgileri.
ManagementLockOwner	Sahip özelliklerini kilitleyin.

LockLevel

Kilidin seviyesi. Olası değerler şunlardır: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete, yetkili kullanıcıların kaynakları okuyup değiştirebileceği ancak silemeyeceği anlamına gelir. ReadOnly, yetkili kullanıcıların yalnızca bir kaynaktan okuyabileceği, ancak kaynağı değiştiremeyecekleri veya silebilecekleri anlamına gelir.

Name	Tür	Description
CanNotDelete	string
NotSpecified	string
ReadOnly	string

ManagementLockObject

Kilit bilgileri.

Name	Tür	Description
id	string	Kilidin kaynak kimliği.
name	string	Kilidin adı.
properties.level	LockLevel	Kilidin seviyesi. Olası değerler şunlardır: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete, yetkili kullanıcıların kaynakları okuyup değiştirebileceği ancak silemeyeceği anlamına gelir. ReadOnly, yetkili kullanıcıların yalnızca bir kaynaktan okuyabileceği, ancak kaynağı değiştiremeyecekleri veya silebilecekleri anlamına gelir.
properties.notes	string	Kilitle ilgili notlar. En fazla 512 karakter.
properties.owners	ManagementLockOwner[]	Kilidin sahipleri.
type	string	Kilidin kaynak türü - Microsoft.Authorization/locks.

ManagementLockOwner

Sahip özelliklerini kilitleyin.

Name	Tür	Description
applicationId	string	Kilit sahibinin uygulama kimliği.