Role Definitions - Get

Belirtilen rol tanımını alın.

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionName}?api-version=7.4

URI Parametreleri

Name İçinde Gerekli Tür Description
roleDefinitionName
path True

string

Alınacak rol tanımının adı.

scope
path True

string

Alınacak rol tanımının kapsamı. Yönetilen HSM yalnızca '/' destekler.

vaultBaseUrl
path True

string

Kasa adı, örneğin https://myvault.vault.azure.net.

api-version
query True

string

İstemci API sürümü.

Yanıtlar

Name Tür Description
200 OK

RoleDefinition

Tamam - Rol tanımı hakkında bilgi döndürür.

Other Status Codes

KeyVaultError

İşlemin neden başarısız olduğunu açıklayan hata yanıtı Key Vault.

Örnekler

GetRoleAssignments

Sample Request

GET https://myvault.vault.azure.net////providers/Microsoft.Authorization/roleDefinitions/00000000-0000-0000-0000-000000000000?api-version=7.4

Sample Response

{
  "properties": {
    "roleName": "My custom role",
    "type": "CustomRole",
    "description": "Role description",
    "assignableScopes": [
      "/"
    ],
    "permissions": [
      {
        "dataActions": [
          "Microsoft.KeyVault/managedHsm/keys/sign/action"
        ]
      }
    ]
  },
  "id": "Microsoft.KeyVault/providers/Microsoft.Authorization/roleDefinitions/00000000-0000-0000-0000-000000000000",
  "type": "Microsoft.Authorization/roleDefinitions",
  "name": "00000000-0000-0000-0000-000000000000"
}

Tanımlar

Name Description
DataAction

Veri eylemleri için desteklenen izinler.

Error

Anahtar kasası sunucusu hatası.

KeyVaultError

Anahtar kasası hata özel durumu.

Permission

Rol tanımı izinleri.

RoleDefinition

Rol tanımı.

RoleDefinitionType

Rol tanımı türü.

RoleScope

Rol kapsamı.

RoleType

Rol türü.

DataAction

Veri eylemleri için desteklenen izinler.

Name Tür Description
Microsoft.KeyVault/managedHsm/backup/start/action

string

Bir HSM yedeklemesi başlatın.

Microsoft.KeyVault/managedHsm/backup/status/action

string

HSM yedekleme durumunu okuyun.

Microsoft.KeyVault/managedHsm/keys/backup/action

string

HSM anahtarlarını yedekleyin.

Microsoft.KeyVault/managedHsm/keys/create

string

Bir HSM anahtarı oluşturun.

Microsoft.KeyVault/managedHsm/keys/decrypt/action

string

HSM anahtarı kullanarak şifre çözme.

Microsoft.KeyVault/managedHsm/keys/delete

string

HSM anahtarını silin.

Microsoft.KeyVault/managedHsm/keys/deletedKeys/delete

string

Silinen bir HSM anahtarını temizleme.

Microsoft.KeyVault/managedHsm/keys/deletedKeys/read/action

string

Silinen HSM anahtarını okuyun.

Microsoft.KeyVault/managedHsm/keys/deletedKeys/recover/action

string

Silinen HSM anahtarını kurtarın.

Microsoft.KeyVault/managedHsm/keys/encrypt/action

string

HSM anahtarı kullanarak şifreleyin.

Microsoft.KeyVault/managedHsm/keys/export/action

string

HSM anahtarını dışarı aktarın.

Microsoft.KeyVault/managedHsm/keys/import/action

string

HSM anahtarını içeri aktar.

Microsoft.KeyVault/managedHsm/keys/read/action

string

HSM anahtar meta verilerini okuyun.

Microsoft.KeyVault/managedHsm/keys/release/action

string

Güvenli Anahtar Yayınını kullanarak bir HSM anahtarı bırakın.

Microsoft.KeyVault/managedHsm/keys/restore/action

string

HSM anahtarlarını geri yükleyin.

Microsoft.KeyVault/managedHsm/keys/sign/action

string

HSM anahtarı kullanarak oturum açın.

Microsoft.KeyVault/managedHsm/keys/unwrap/action

string

HSM anahtarı kullanarak sarmayı kaldırın.

Microsoft.KeyVault/managedHsm/keys/verify/action

string

HSM anahtarı kullanarak doğrulayın.

Microsoft.KeyVault/managedHsm/keys/wrap/action

string

HSM anahtarı kullanarak sarmalama.

Microsoft.KeyVault/managedHsm/keys/write/action

string

HSM anahtarını güncelleştirin.

Microsoft.KeyVault/managedHsm/restore/start/action

string

HSM geri yükleme işlemi başlatın.

Microsoft.KeyVault/managedHsm/restore/status/action

string

HSM geri yükleme durumunu okuyun.

Microsoft.KeyVault/managedHsm/rng/action

string

Rastgele sayılar oluşturma.

Microsoft.KeyVault/managedHsm/roleAssignments/delete/action

string

Rol ataması silin.

Microsoft.KeyVault/managedHsm/roleAssignments/read/action

string

Rol ataması alın.

Microsoft.KeyVault/managedHsm/roleAssignments/write/action

string

Rol ataması oluşturun veya güncelleştirin.

Microsoft.KeyVault/managedHsm/roleDefinitions/delete/action

string

Rol tanımını silin.

Microsoft.KeyVault/managedHsm/roleDefinitions/read/action

string

Rol tanımını alın.

Microsoft.KeyVault/managedHsm/roleDefinitions/write/action

string

Rol tanımını oluşturun veya güncelleştirin.

Microsoft.KeyVault/managedHsm/securitydomain/download/action

string

HSM güvenlik etki alanını indirin.

Microsoft.KeyVault/managedHsm/securitydomain/download/read

string

HSM güvenlik etki alanı indirme durumunu denetleyin.

Microsoft.KeyVault/managedHsm/securitydomain/transferkey/read

string

HSM güvenlik etki alanı aktarım anahtarını indirin.

Microsoft.KeyVault/managedHsm/securitydomain/upload/action

string

Bir HSM güvenlik etki alanını karşıya yükleyin.

Microsoft.KeyVault/managedHsm/securitydomain/upload/read

string

HSM güvenlik etki alanı exchange dosyasının durumunu denetleyin.

Error

Anahtar kasası sunucusu hatası.

Name Tür Description
code

string

Hata kodu.

innererror

Error

Anahtar kasası sunucusu hatası.

message

string

Hata iletisi.

KeyVaultError

Anahtar kasası hata özel durumu.

Name Tür Description
error

Error

Anahtar kasası sunucusu hatası.

Permission

Rol tanımı izinleri.

Name Tür Description
actions

string[]

Verilen eylem izinleri.

dataActions

DataAction[]

Verilen veri eylemi izinleri.

notActions

string[]

Dışlanan ancak reddedilmeyen eylem izinleri. Bunlar bir sorumluya atanan diğer rol tanımları tarafından verilebilir.

notDataActions

DataAction[]

Dışlanan ancak reddedilmeyen veri eylemi izinleri. Bunlar bir sorumluya atanan diğer rol tanımları tarafından verilebilir.

RoleDefinition

Rol tanımı.

Name Tür Description
id

string

Rol tanımı kimliği.

name

string

Rol tanımı adı.

properties.assignableScopes

RoleScope[]

Rol tanımı atanabilir kapsamlar.

properties.description

string

Rol tanımı açıklaması.

properties.permissions

Permission[]

Rol tanımı izinleri.

properties.roleName

string

Rol adı.

properties.type

RoleType

Rol türü.

type

RoleDefinitionType

Rol tanımı türü.

RoleDefinitionType

Rol tanımı türü.

Name Tür Description
Microsoft.Authorization/roleDefinitions

string

RoleScope

Rol kapsamı.

Name Tür Description
/

string

Genel kapsam

/keys

string

Anahtar kapsamı

RoleType

Rol türü.

Name Tür Description
AKVBuiltInRole

string

Yerleşik rol.

CustomRole

string

Özel rol.