Management Locks - Create Or Update At Resource Level

Služba:

Resource Management

Verze rozhraní API:

2016-09-01

Vytvoří nebo aktualizuje zámek správy na úrovni prostředku nebo na jakékoli úrovni pod prostředkem.
Když zámek použijete u nadřazeného oboru, všechny podřízené prostředky dědí stejný zámek. Pokud chcete vytvořit zámky správy, musíte mít přístup k akcím Microsoft.Authorization/* nebo Microsoft.Authorization/locks/*. Z předdefinovaných rolí má tyto akce povolené pouze vlastník a správce uživatelských přístupů.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
lockName	path	True	string	Název zámku. Název zámku může mít maximálně 260 znaků. Nesmí obsahovat <, > %, &, :, , , ?, /nebo žádné řídicí znaky.
parentResourcePath	path	True	string	Identita nadřazeného prostředku.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+$	Název skupiny prostředků obsahující prostředek, který se má uzamknout.
resourceName	path	True	string	Název prostředku, který se má uzamknout.
resourceProviderNamespace	path	True	string	Obor názvů poskytovatele prostředků prostředku, který se má uzamknout.
resourceType	path	True	string	Typ prostředku, který se má uzamknout.
subscriptionId	path	True	string	ID cílového předplatného.
api-version	query	True	string	Verze rozhraní API, která se má použít pro operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
properties.level	True	LockLevel	Úroveň zámku. Možné hodnoty jsou: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete znamená, že autorizovaní uživatelé můžou číst a upravovat prostředky, ale ne odstranit. Jen pro čtení znamená, že autorizovaní uživatelé můžou číst jenom z prostředku, ale nemůžou ho upravovat ani odstraňovat.
properties.notes		string	Poznámky k zámku Maximálně 512 znaků.
properties.owners		ManagementLockOwner[]	Vlastníci zámku.

Odpovědi

Name	Typ	Description
200 OK	ManagementLockObject	OK - Vrátí informace o zámku.
201 Created	ManagementLockObject	Vytvořeno – vrátí informace o zámku.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Příklady

Create management lock at resource level

Ukázkový požadavek

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 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

Ukázková odpověď

Stavový kód:

201

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

Stavový kód:

200

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

Definice

Name	Description
LockLevel	Úroveň zámku. Možné hodnoty jsou: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete znamená, že autorizovaní uživatelé můžou číst a upravovat prostředky, ale ne odstranit. Jen pro čtení znamená, že autorizovaní uživatelé můžou číst jenom z prostředku, ale nemůžou ho upravovat ani odstraňovat.
ManagementLockObject	Informace o zámku.
ManagementLockOwner	Uzamknout vlastnosti vlastníka

LockLevel

Výčet

Úroveň zámku. Možné hodnoty jsou: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete znamená, že autorizovaní uživatelé můžou číst a upravovat prostředky, ale ne odstranit. Jen pro čtení znamená, že autorizovaní uživatelé můžou číst jenom z prostředku, ale nemůžou ho upravovat ani odstraňovat.

Hodnota	Description
CanNotDelete
NotSpecified
ReadOnly

ManagementLockObject

Objekt

Informace o zámku.

Name	Typ	Description
id	string	ID prostředku zámku.
name	string	Název zámku.
properties.level	LockLevel	Úroveň zámku. Možné hodnoty jsou: NotSpecified, CanNotDelete, ReadOnly. CanNotDelete znamená, že autorizovaní uživatelé můžou číst a upravovat prostředky, ale ne odstranit. Jen pro čtení znamená, že autorizovaní uživatelé můžou číst jenom z prostředku, ale nemůžou ho upravovat ani odstraňovat.
properties.notes	string	Poznámky k zámku Maximálně 512 znaků.
properties.owners	ManagementLockOwner[]	Vlastníci zámku.
type	string	Typ prostředku zámku – Microsoft.Authorization/locks.

ManagementLockOwner

Objekt

Uzamknout vlastnosti vlastníka

Name	Typ	Description
applicationId	string	ID aplikace vlastníka zámku.