Registration Assignments - Create Or Update

Service:

Managed Services

API Version:

2022-10-01

Regisztrációs hozzárendelést hoz létre vagy frissít.

PUT https://management.azure.com/{scope}/providers/Microsoft.ManagedServices/registrationAssignments/{registrationAssignmentId}?api-version=2022-10-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
registrationAssignmentId	path	True	string	A regisztrációs hozzárendelés GUID azonosítója.
scope	path	True	string	Az erőforrás hatóköre.
api-version	query	True	string	A művelethez használandó API-verzió.

Kérelem törzse

Name	Típus	Description
properties	RegistrationAssignmentProperties	A regisztrációs hozzárendelés tulajdonságai.

Válaszok

Name	Típus	Description
200 OK	RegistrationAssignment	Ok – A frissített regisztrációs hozzárendeléssel kapcsolatos információkat adja vissza.
201 Created	RegistrationAssignment	Created – A létrehozott regisztrációs hozzárendeléssel kapcsolatos információkat adja vissza.
Other Status Codes	ErrorResponse	A művelet meghiúsulásának okát leíró hibaválasz.

Biztonság

azure_auth

Az Azure Active Directory OAuth2-folyamat

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

Példák

Put Registration Assignment

Sample Request

HTTP

PUT https://management.azure.com/subscription/0afefe50-734e-4610-8a82-a144ahf49dea/providers/Microsoft.ManagedServices/registrationAssignments/26c128c2-fefa-4340-9bb1-6e081c90ada2?api-version=2022-10-01

{
  "properties": {
    "registrationDefinitionId": "/subscriptions/0afefe50-734e-4610-8a82-a144ahf49dea/providers/Microsoft.ManagedServices/registrationDefinitions/26c128c2-fefa-4340-9bb1-6e081c90ada2"
  }
}

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.managedservices import ManagedServicesClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-managedservices
# USAGE
    python put_registration_assignment.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 = ManagedServicesClient(
        credential=DefaultAzureCredential(),
    )

    response = client.registration_assignments.begin_create_or_update(
        scope="subscription/0afefe50-734e-4610-8a82-a144ahf49dea",
        registration_assignment_id="26c128c2-fefa-4340-9bb1-6e081c90ada2",
        request_body={
            "properties": {
                "registrationDefinitionId": "/subscriptions/0afefe50-734e-4610-8a82-a144ahf49dea/providers/Microsoft.ManagedServices/registrationDefinitions/26c128c2-fefa-4340-9bb1-6e081c90ada2"
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/managedservices/resource-manager/Microsoft.ManagedServices/stable/2022-10-01/examples/PutRegistrationAssignment.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

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.ManagedServices;
using Azure.ResourceManager.ManagedServices.Models;

// Generated from example definition: specification/managedservices/resource-manager/Microsoft.ManagedServices/stable/2022-10-01/examples/PutRegistrationAssignment.json
// this example is just showing the usage of "RegistrationAssignments_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ManagedServicesRegistrationAssignmentResource created on azure
// for more information of creating ManagedServicesRegistrationAssignmentResource, please refer to the document of ManagedServicesRegistrationAssignmentResource
string scope = "subscription/0afefe50-734e-4610-8a82-a144ahf49dea";
string registrationAssignmentId = "26c128c2-fefa-4340-9bb1-6e081c90ada2";
ResourceIdentifier managedServicesRegistrationAssignmentResourceId = ManagedServicesRegistrationAssignmentResource.CreateResourceIdentifier(scope, registrationAssignmentId);
ManagedServicesRegistrationAssignmentResource managedServicesRegistrationAssignment = client.GetManagedServicesRegistrationAssignmentResource(managedServicesRegistrationAssignmentResourceId);

// invoke the operation
ManagedServicesRegistrationAssignmentData data = new ManagedServicesRegistrationAssignmentData()
{
    Properties = new ManagedServicesRegistrationAssignmentProperties(new ResourceIdentifier("/subscriptions/0afefe50-734e-4610-8a82-a144ahf49dea/providers/Microsoft.ManagedServices/registrationDefinitions/26c128c2-fefa-4340-9bb1-6e081c90ada2")),
};
ArmOperation<ManagedServicesRegistrationAssignmentResource> lro = await managedServicesRegistrationAssignment.UpdateAsync(WaitUntil.Completed, data);
ManagedServicesRegistrationAssignmentResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ManagedServicesRegistrationAssignmentData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Sample Response

Status code:

200

{
  "properties": {
    "registrationDefinitionId": "/subscriptions/0afefe50-734e-4610-8c82-a144aff49dea/providers/Microsoft.ManagedServices/registrationDefinitions/26c128c2-fefa-4340-9bb1-8e081c90ada2",
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/0afefe50-734e-4610-8c82-a144aff49dea/providers/Microsoft.ManagedServices/registrationAssignments/484a7d5f-9729-4b87-bc9b-26610985a013",
  "type": "Microsoft.ManagedServices/registrationAssignments",
  "name": "484a7d5f-9729-4b87-bc9b-26610985a013"
}

Status code:

201

{
  "properties": {
    "registrationDefinitionId": "/subscriptions/0afefe50-734e-4610-8c82-a144aff49dea/providers/Microsoft.ManagedServices/registrationDefinitions/26c128c2-fefa-4340-9bb1-8e081c90ada2",
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/0afefe50-734e-4610-8c82-a144aff49dea/providers/Microsoft.ManagedServices/registrationAssignments/484a7d5f-9729-4b87-bc9b-26610985a013",
  "type": "Microsoft.ManagedServices/registrationAssignments",
  "name": "484a7d5f-9729-4b87-bc9b-26610985a013"
}

Definíciók

Name	Description
Authorization	Az Azure Active Directory egyszerű azonosítója és az Azure beépített szerepköre, amely leírja, hogy a rendszerbiztonsági tag milyen hozzáférést kap a felügyelt bérlő delegált erőforrásán.
createdByType	Az erőforrást létrehozó identitás típusa.
EligibleApprover	Meghatározza az Azure Active Directory-résztvevőt, amely jóváhagyhatja a EligibleAuthorizationben meghatározott rendszerbiztonsági tag által adott igény szerinti hozzáférési kéréseket.
EligibleAuthorization	Az Azure Active Directory egyszerű azonosítója, az Azure beépített szerepköre és az igény szerint hozzáférési szabályzat, amely leírja, hogy az egyszerű felhasználó milyen igény szerint férhet hozzá a felügyelt bérlő delegált erőforrásához.
ErrorDefinition	A hibaüzenet, amely jelzi, hogy miért nem sikerült feldolgozni a bejövő kérést
ErrorResponse	Hibaválasz.
JustInTimeAccessPolicy	Igény szerint hozzáférési szabályzat beállítása.
MultiFactorAuthProvider	A többtényezős engedélyezési szolgáltató, amelyet az igényalapú hozzáférési kérelmekhez kell használni.
Plan	A felügyelt szolgáltatások ajánlatának részletei a Azure Marketplace.
ProvisioningState	A regisztrációs definíció aktuális kiépítési állapota.
RegistrationAssignment	A regisztrációs hozzárendelés.
RegistrationAssignmentProperties	A regisztrációs hozzárendelés tulajdonságai.
RegistrationDefinition	A regisztrációs definíció.
RegistrationDefinitionProperties	A regisztrációs definíció tulajdonságai.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Authorization

Az Azure Active Directory egyszerű azonosítója és az Azure beépített szerepköre, amely leírja, hogy a rendszerbiztonsági tag milyen hozzáférést kap a felügyelt bérlő delegált erőforrásán.

Name	Típus	Description
delegatedRoleDefinitionIds	string[]	A delegatedRoleDefinitionIds mezőre akkor van szükség, ha a roleDefinitionId a felhasználói hozzáférés rendszergazdai szerepkörére hivatkozik. Ez a szerepkör-definíciós azonosítók listája, amelyek meghatározzák azokat az engedélyeket, amelyeket az engedélyben szereplő felhasználó más tagokhoz rendelhet.
principalId	string	Az Azure Active Directory-résztvevő azonosítója.
principalIdDisplayName	string	Az Azure Active Directory-résztvevő megjelenítendő neve.
roleDefinitionId	string	A beépített Azure-szerepkör azonosítója, amely meghatározza, hogy az Azure Active Directory-résztvevő milyen engedélyekkel rendelkezzen a tervezett hatókörben.

createdByType

Az erőforrást létrehozó identitás típusa.

Name	Típus	Description
Application	string
Key	string
ManagedIdentity	string
User	string

EligibleApprover

Meghatározza az Azure Active Directory-résztvevőt, amely jóváhagyhatja a EligibleAuthorizationben meghatározott rendszerbiztonsági tag által adott igény szerinti hozzáférési kéréseket.

Name	Típus	Description
principalId	string	Az Azure Active Directory-résztvevő azonosítója.
principalIdDisplayName	string	Az Azure Active Directory-résztvevő megjelenítendő neve.

EligibleAuthorization

Az Azure Active Directory egyszerű azonosítója, az Azure beépített szerepköre és az igény szerint hozzáférési szabályzat, amely leírja, hogy az egyszerű felhasználó milyen igény szerint férhet hozzá a felügyelt bérlő delegált erőforrásához.

Name	Típus	Description
justInTimeAccessPolicy	JustInTimeAccessPolicy	Az igény szerint megadott hozzáférési házirend-beállítás.
principalId	string	Az Azure Active Directory-résztvevő azonosítója.
principalIdDisplayName	string	Az Azure Active Directory-résztvevő megjelenítendő neve.
roleDefinitionId	string	A beépített Azure-szerepkör azonosítója, amely meghatározza, hogy az Azure Active Directory-résztvevő milyen engedélyekkel rendelkezzen a tervezett hatókörben.

ErrorDefinition

A hibaüzenet, amely jelzi, hogy miért nem sikerült feldolgozni a bejövő kérést

Name	Típus	Description
code	string	A hibakód.
details	ErrorDefinition[]	A belső hiba részletei.
message	string	A művelet sikertelen voltát jelző hibaüzenet.

ErrorResponse

Hibaválasz.

Name	Típus	Description
error	ErrorDefinition	A hiba részletei.

JustInTimeAccessPolicy

Igény szerint hozzáférési szabályzat beállítása.

Name	Típus	Alapértelmezett érték	Description
managedByTenantApprovers	EligibleApprover[]		A jogosult engedélyezéshez tartozó managedByTenant jóváhagyók listája.
maximumActivationDuration	string	PT8H	A hozzáférési kérelmek maximális hozzáférési időtartama ISO 8601 formátumban.
multiFactorAuthProvider	MultiFactorAuthProvider	None	A többtényezős engedélyezési szolgáltató, amelyet az igényalapú hozzáférési kérelmekhez kell használni.

MultiFactorAuthProvider

A többtényezős engedélyezési szolgáltató, amelyet az igényalapú hozzáférési kérelmekhez kell használni.

Name	Típus	Description
Azure	string
None	string

Plan

A felügyelt szolgáltatások ajánlatának részletei a Azure Marketplace.

Name	Típus	Description
name	string	Azure Marketplace terv neve.
product	string	Azure Marketplace termékkódot.
publisher	string	Azure Marketplace közzétevő azonosítója.
version	string	Azure Marketplace csomag verzióját.

ProvisioningState

A regisztrációs definíció aktuális kiépítési állapota.

Name	Típus	Description
Accepted	string
Canceled	string
Created	string
Creating	string
Deleted	string
Deleting	string
Failed	string
NotSpecified	string
Ready	string
Running	string
Succeeded	string
Updating	string

RegistrationAssignment

A regisztrációs hozzárendelés.

Name	Típus	Description
id	string	A regisztrációs hozzárendelés teljes elérési útja.
name	string	A regisztrációs hozzárendelés neve.
properties	RegistrationAssignmentProperties	A regisztrációs hozzárendelés tulajdonságai.
systemData	systemData	A regisztrációs hozzárendelési erőforrás metaadatai.
type	string	Az Azure-erőforrás típusa (Microsoft.ManagedServices/registrationAssignments).

RegistrationAssignmentProperties

A regisztrációs hozzárendelés tulajdonságai.

Name	Típus	Description
provisioningState	ProvisioningState	A regisztrációs hozzárendelés aktuális kiépítési állapota.
registrationDefinition	RegistrationDefinition	A regisztrációs hozzárendeléshez társított regisztrációs definíció.
registrationDefinitionId	string	A regisztrációs definíció teljes elérési útja.

RegistrationDefinition

A regisztrációs definíció.

Name	Típus	Description
id	string	A regisztrációs definíció teljes elérési útja.
name	string	A regisztrációs definíció neve.
plan	Plan	A felügyelt szolgáltatások ajánlatának részletei a Azure Marketplace.
properties	RegistrationDefinitionProperties	A regisztrációs definíció tulajdonságai.
systemData	systemData	A regisztrációs hozzárendelési erőforrás metaadatai.
type	string	Az Azure-erőforrás típusa (Microsoft.ManagedServices/registrationDefinitions).

RegistrationDefinitionProperties

A regisztrációs definíció tulajdonságai.

Name	Típus	Description
authorizations	Authorization[]	A felügyelt bérlőben lévő azure Active Directory-tagok hozzáférését leíró engedélyezési objektumok gyűjteménye a felügyelt bérlő delegált erőforrására fog érkezni.
description	string	A regisztrációs definíció leírása.
eligibleAuthorizations	EligibleAuthorization[]	A felügyelt bérlőben lévő, igény szerint elérhető Azure Active Directory-rendszerbiztonsági tagokat leíró jogosult engedélyezési objektumok gyűjteménye a felügyelt bérlő delegált erőforrásán fog érkezni.
managedByTenantId	string	A managedBy-bérlő azonosítója.
managedByTenantName	string	A managedBy bérlő neve.
manageeTenantId	string	A felügyelt bérlő azonosítója.
manageeTenantName	string	A felügyelt bérlő neve.
provisioningState	ProvisioningState	A regisztrációs definíció aktuális kiépítési állapota.
registrationDefinitionName	string	A regisztrációs definíció neve.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást utoljára módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.