Role Definitions - Create Or Update

Service:

Authorization

API Version:

2015-07-01

Membuat atau memperbarui definisi peran.

PUT https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionId}?api-version=2015-07-01

Parameter URI

Name	In	Required	Type	Description
roleDefinitionId	path	True	string	ID definisi peran.
scope	path	True	string	Cakupan definisi peran.
api-version	query	True	string	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Name	Type	Description
properties.assignableScopes	string[]	Cakupan yang dapat ditetapkan definisi peran.
properties.description	string	Deskripsi definisi peran.
properties.permissions	Permission[]	Izin definisi peran.
properties.roleName	string	Nama peran.
properties.type	string	Jenis peran.

Respons

Name	Type	Description
201 Created	RoleDefinition	OK - Mengembalikan informasi tentang definisi peran.
Other Status Codes	ErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name	Description
user_impersonation	meniru akun pengguna Anda

Contoh

Create role definition

Sample Request

HTTP

PUT https://management.azure.com/scope/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId?api-version=2015-07-01

{}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.authorization.fluent.models.RoleDefinitionInner;

/** Samples for RoleDefinitions CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/authorization/resource-manager/Microsoft.Authorization/stable/2015-07-01/examples/PutRoleDefinition.json
     */
    /**
     * Sample code: Create role definition.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createRoleDefinition(com.azure.resourcemanager.AzureResourceManager azure) {
        azure
            .accessManagement()
            .roleAssignments()
            .manager()
            .roleServiceClient()
            .getRoleDefinitions()
            .createOrUpdateWithResponse("scope", "roleDefinitionId", new RoleDefinitionInner(), Context.NONE);
    }
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Go

package armauthorization_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/authorization/armauthorization"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/authorization/resource-manager/Microsoft.Authorization/stable/2015-07-01/examples/PutRoleDefinition.json
func ExampleRoleDefinitionsClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armauthorization.NewRoleDefinitionsClient(cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	_, err = client.CreateOrUpdate(ctx,
		"scope",
		"roleDefinitionId",
		armauthorization.RoleDefinition{},
		nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:

201

{
  "properties": {
    "roleName": "Role name",
    "type": "roletype",
    "description": "Role description",
    "assignableScopes": [
      "/subscriptions/subId"
    ],
    "permissions": [
      {
        "actions": [
          "action"
        ],
        "notActions": []
      }
    ]
  },
  "id": "/subscriptions/subID/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
  "type": "Microsoft.Authorization/roleDefinitions",
  "name": "roleDefinitionId"
}

Definisi

ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
Permission	Izin definisi peran.
RoleDefinition	Definisi peran.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Name	Type	Description
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Respons kesalahan

Name	Type	Description
error	ErrorDetail	Objek kesalahan.

Permission

Izin definisi peran.

Name	Type	Description
actions	string[]	Tindakan yang diizinkan.
notActions	string[]	Tindakan yang ditolak.

RoleDefinition

Definisi peran.

Name	Type	Description
id	string	ID definisi peran.
name	string	Nama definisi peran.
properties.assignableScopes	string[]	Cakupan yang dapat ditetapkan definisi peran.
properties.description	string	Deskripsi definisi peran.
properties.permissions	Permission[]	Izin definisi peran.
properties.roleName	string	Nama peran.
properties.type	string	Jenis peran.
type	string	Jenis definisi peran.