Role Assignments - Create

Service:

Key Vault

API Version:

7.4

Vytvoří přiřazení role.

PUT {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=7.4

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
roleAssignmentName	path	True	string	Název přiřazení role, která se má vytvořit. Může to být libovolný platný identifikátor GUID.
scope	path	True	string	Obor přiřazení role, která se má vytvořit.
vaultBaseUrl	path	True	string	Název trezoru, například https://myvault.vault.azure.net.
api-version	query	True	string	Verze rozhraní API klienta.

Text požadavku

Name	Vyžadováno	Typ	Description
properties	True	RoleAssignmentProperties	Vlastnosti přiřazení role.

Odpovědi

Name	Typ	Description
201 Created	RoleAssignment	Vytvořeno – vrátí informace o přiřazení role.
Other Status Codes	KeyVaultError	Key Vault chybovou odpověď popisující, proč operace selhala.

Příklady

PutRoleAssignments

Sample Request

HTTP

PUT https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentName?api-version=7.4

{
  "properties": {
    "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
    "principalId": "principalId"
  }
}

Sample Response

Status code:

201

{
  "properties": {
    "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
    "principalId": "principalId",
    "scope": "/keys"
  },
  "id": "/keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentId",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "roleAssignmentId"
}

Definice

Name	Description
Error	Chyba serveru trezoru klíčů.
KeyVaultError	Výjimka chyby trezoru klíčů
RoleAssignment	Přiřazení rolí
RoleAssignmentCreateParameters	Parametry pro vytvoření přiřazení role
RoleAssignmentProperties	Vlastnosti přiřazení role.
RoleAssignmentPropertiesWithScope	Vlastnosti přiřazení role s oborem
RoleScope	Obor role.

Error

Chyba serveru trezoru klíčů.

Name	Typ	Description
code	string	Kód chyby
innererror	Error	Chyba serveru trezoru klíčů.
message	string	Chybová zpráva

KeyVaultError

Výjimka chyby trezoru klíčů

Name	Typ	Description
error	Error	Chyba serveru trezoru klíčů.

RoleAssignment

Přiřazení rolí

Name	Typ	Description
id	string	ID přiřazení role.
name	string	Název přiřazení role.
properties	RoleAssignmentPropertiesWithScope	Vlastnosti přiřazení role.
type	string	Typ přiřazení role.

RoleAssignmentCreateParameters

Parametry pro vytvoření přiřazení role

Name	Typ	Description
properties	RoleAssignmentProperties	Vlastnosti přiřazení role.

RoleAssignmentProperties

Vlastnosti přiřazení role.

Name	Typ	Description
principalId	string	ID objektu zabezpečení přiřazené roli. To se mapuje na ID ve službě Active Directory. Může odkazovat na uživatele, instanční objekt nebo skupinu zabezpečení.
roleDefinitionId	string	ID definice role použité v přiřazení role.

RoleAssignmentPropertiesWithScope

Vlastnosti přiřazení role s oborem

Name	Typ	Description
principalId	string	ID objektu zabezpečení.
roleDefinitionId	string	ID definice role.
scope	RoleScope	Obor role.

RoleScope

Obor role.

Name	Typ	Description
/	string	Globální rozsah
/keys	string	Rozsah klíčů