Share via


Role Assignments - Create By Id

Criar ou atualizar uma atribuição de função por ID.

PUT https://management.azure.com/{roleAssignmentId}?api-version=2022-04-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
roleAssignmentId
path True

string

A ID totalmente qualificada da atribuição de função, incluindo escopo, nome do recurso e tipo de recurso. Formato: /{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}. Exemplo: /subscriptions/<SUB_ID>/resourcegroups/<RESOURCE_GROUP>/providers/Microsoft.Authorization/roleAssignments/<ROLE_ASSIGNMENT_NAME>

api-version
query True

string

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
properties.principalId True

string

A ID da entidade de segurança.

properties.roleDefinitionId True

string

A ID de definição de função.

properties.condition

string

As condições na atribuição de função. Isso limita os recursos aos quais ele pode ser atribuído. por exemplo: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Versão da condição. Atualmente, o único valor aceito é '2.0'

properties.delegatedManagedIdentityResourceId

string

ID do recurso de identidade gerenciada delegado

properties.description

string

Descrição da atribuição de função

properties.principalType

PrincipalType

O tipo principal da ID da entidade de segurança atribuída.

Respostas

Nome Tipo Description
200 OK

RoleAssignment

Retorna a atribuição de função.

201 Created

RoleAssignment

Retorna a atribuição de função.

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Create or update role assignment by ID

Sample Request

PUT https://management.azure.com/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747?api-version=2022-04-01

{
  "properties": {
    "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
    "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
    "principalType": "User"
  }
}

Sample Response

{
  "properties": {
    "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
    "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
    "principalType": "User",
    "scope": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2"
  },
  "id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "b0f43c54-e787-4862-89b1-a653fa9cf747"
}
{
  "properties": {
    "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
    "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
    "principalType": "User",
    "scope": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2"
  },
  "id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "b0f43c54-e787-4862-89b1-a653fa9cf747"
}

Definições

Nome Description
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

PrincipalType

O tipo principal da ID da entidade de segurança atribuída.

RoleAssignment

Atribuições de Funções

RoleAssignmentCreateParameters

Parâmetros de criação de atribuição de função.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

PrincipalType

O tipo principal da ID da entidade de segurança atribuída.

Nome Tipo Description
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RoleAssignment

Atribuições de Funções

Nome Tipo Valor padrão Description
id

string

ID de atribuição de função.

name

string

O nome da atribuição de função.

properties.condition

string

As condições na atribuição de função. Isso limita os recursos aos quais ele pode ser atribuído. por exemplo: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Versão da condição. Atualmente, o único valor aceito é '2.0'

properties.createdBy

string

Id do usuário que criou a atribuição

properties.createdOn

string

Hora em que foi criado

properties.delegatedManagedIdentityResourceId

string

ID do recurso de identidade gerenciada delegado

properties.description

string

Descrição da atribuição de função

properties.principalId

string

A ID da entidade de segurança.

properties.principalType

PrincipalType

User

O tipo principal da ID da entidade de segurança atribuída.

properties.roleDefinitionId

string

A ID de definição de função.

properties.scope

string

O escopo da atribuição de função.

properties.updatedBy

string

Id do usuário que atualizou a atribuição

properties.updatedOn

string

Hora em que ele foi atualizado

type

string

O tipo de atribuição de função.

RoleAssignmentCreateParameters

Parâmetros de criação de atribuição de função.

Nome Tipo Valor padrão Description
properties.condition

string

As condições na atribuição de função. Isso limita os recursos aos quais ele pode ser atribuído. por exemplo: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Versão da condição. Atualmente, o único valor aceito é '2.0'

properties.createdBy

string

Id do usuário que criou a atribuição

properties.createdOn

string

Hora em que foi criado

properties.delegatedManagedIdentityResourceId

string

ID do recurso de identidade gerenciada delegado

properties.description

string

Descrição da atribuição de função

properties.principalId

string

A ID da entidade de segurança.

properties.principalType

PrincipalType

User

O tipo principal da ID da entidade de segurança atribuída.

properties.roleDefinitionId

string

A ID de definição de função.

properties.scope

string

O escopo da atribuição de função.

properties.updatedBy

string

Id do usuário que atualizou a atribuição

properties.updatedOn

string

Hora em que ele foi atualizado