Management Locks - Create Or Update At Resource Level

Layanan:

Resource Management

Versi API:

2016-09-01

Membuat atau memperbarui kunci manajemen di tingkat sumber daya atau tingkat apa pun di bawah sumber daya.
Saat Anda menerapkan kunci pada cakupan induk, semua sumber daya turunan mewarisi kunci yang sama. Untuk membuat kunci manajemen, Anda harus memiliki akses ke tindakan Microsoft.Authorization/* atau Microsoft.Authorization/locks/*. Dari peran bawaan, hanya Pemilik dan Administrator Akses Pengguna yang diberikan tindakan tersebut.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
lockName	path	True	string	Nama kunci. Nama kunci dapat maksimal 260 karakter. Ini tidak boleh berisi <, > %, &, :, , ?, /, atau karakter kontrol apa pun.
parentResourcePath	path	True	string	Identitas sumber daya induk.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+$	Nama grup sumber daya yang berisi sumber daya untuk dikunci.
resourceName	path	True	string	Nama sumber daya yang akan dikunci.
resourceProviderNamespace	path	True	string	Namespace penyedia sumber daya sumber daya yang akan dikunci.
resourceType	path	True	string	Jenis sumber daya sumber daya yang akan dikunci.
subscriptionId	path	True	string	ID langganan target.
api-version	query	True	string	Versi API yang akan digunakan untuk operasi.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
properties.level	True	LockLevel	Tingkat kunci. Nilai yang mungkin adalah: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete berarti pengguna yang berwenang dapat membaca dan memodifikasi sumber daya, tetapi tidak menghapus. ReadOnly berarti pengguna yang berwenang hanya dapat membaca dari sumber daya, tetapi mereka tidak dapat mengubah atau menghapusnya.
properties.notes		string	Catatan tentang kunci. Maksimum 512 karakter.
properties.owners		ManagementLockOwner[]	Pemilik kunci.

Respons

Nama	Jenis	Deskripsi
200 OK	ManagementLockObject	OK - Mengembalikan informasi tentang kunci.
201 Created	ManagementLockObject	Dibuat - Mengembalikan informasi tentang kunci.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Create management lock at resource level

Permintaan sampel

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 azure.identity import DefaultAzureCredential

from azure.mgmt.resource.locks 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

Respon sampel

Kode status:

201

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

Kode status:

200

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

Definisi

Nama	Deskripsi
LockLevel	Tingkat kunci. Nilai yang mungkin adalah: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete berarti pengguna yang berwenang dapat membaca dan memodifikasi sumber daya, tetapi tidak menghapus. ReadOnly berarti pengguna yang berwenang hanya dapat membaca dari sumber daya, tetapi mereka tidak dapat mengubah atau menghapusnya.
ManagementLockObject	Informasi kunci.
ManagementLockOwner	Kunci properti pemilik.

LockLevel

Enumeration

Tingkat kunci. Nilai yang mungkin adalah: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete berarti pengguna yang berwenang dapat membaca dan memodifikasi sumber daya, tetapi tidak menghapus. ReadOnly berarti pengguna yang berwenang hanya dapat membaca dari sumber daya, tetapi mereka tidak dapat mengubah atau menghapusnya.

Nilai	Deskripsi
CanNotDelete
NotSpecified
ReadOnly

ManagementLockObject

Objek

Informasi kunci.

Nama	Jenis	Deskripsi
id	string	ID sumber daya kunci.
name	string	Nama kunci.
properties.level	LockLevel	Tingkat kunci. Nilai yang mungkin adalah: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete berarti pengguna yang berwenang dapat membaca dan memodifikasi sumber daya, tetapi tidak menghapus. ReadOnly berarti pengguna yang berwenang hanya dapat membaca dari sumber daya, tetapi mereka tidak dapat mengubah atau menghapusnya.
properties.notes	string	Catatan tentang kunci. Maksimum 512 karakter.
properties.owners	ManagementLockOwner[]	Pemilik kunci.
type	string	Jenis sumber daya kunci - Microsoft.Authorization/locks.

ManagementLockOwner

Objek

Kunci properti pemilik.

Nama	Jenis	Deskripsi
applicationId	string	ID aplikasi pemilik kunci.