Create or Update Role Assignment (ARM)

[This topic is pre-release documentation and is subject to change.]

Creates a new or updates an existing Role Assignment in a Customer Insights Hub.

Request

The request is constructed as follows:

HTTP Verb Request URI
PUT https://management.azure.com/subscriptions/<subId>/resourceGroups/<rgName>/providers/Microsoft.CustomerInsights/hubs/<hubName>/roleAssignments/<assignmentName>?api-version=2017-04-26

URI Parameters

URI Parameter Required Description
subId Yes The Azure subscription ID
rgName Yes The resource group name
hubName Yes Name of your Customer Insights Hub
assignmentName Yes The name of the Role Assignment to create or update

Request Body

A JSON object describing a Role Assignment type, for example:

{
    "role": "Admin",
    "principals": [{
        "principalId": "4c54c38ffa9b416ba5a6d6c8a20cbe7e",
        "principalType": "User"
    },
    {
        "principalId": "93061d15a5054f2b9948ae25724cf9d5",
        "principalType": "User"
    }]
}

Response

The response includes an HTTP status code and a standard set of response headers. Upon success, the body will contain information about the newly created role in the following form:

{ 
     'id':'/subscriptions/<subId>/resourceGroups/<rgName>/providers/Microsoft.CustomerInsights/hubs/<hubName>/RoleAssignments/<assignmentName>' 
     'name':'<hubName>/<assignmentName>, 
     'type':'Microsoft.CustomerInsights/hubs/RoleAssignments', 
     'properties': <RoleAssignment-Definition>
 } 

Where properties contains a Role Assignment type definition.

Status Code

  • 200 (OK) - Update request completed successfully.
  • 202 (Accepted) - Update request accepted and is being processed.
  • 400 (Bad Request) - Validation fails or invalid JSON.