Sql Resources - Create Update Sql Role Assignment

  • Ссылка
Service:
Cosmos DB Resource Provider
API Version:
2021-04-01-preview

Создает или обновляет назначение Cosmos ролей SQL базы данных Azure SQL.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlRoleAssignments/{roleAssignmentId}?api-version=2021-04-01-preview

Параметры URI

Name In Required Type Description
accountName
 path True
  • string

Cosmos имя учетной записи базы данных базы данных.

Regex pattern: ^[a-z0-9]+(-[a-z0-9]+)*
resourceGroupName
 path True
  • string

Имя группы ресурсов. Регистр букв в имени не учитывается.
roleAssignmentId
 path True
  • string

GUID для назначения ролей.
subscriptionId
 path True
  • string

Идентификатор целевой подписки.
api-version
 query True
  • string

Версия API, используемая для этой операции.

Текст запроса

Name Type Description
properties.principalId
  • string

Уникальный идентификатор связанного субъекта AAD в графе AAD, к которому предоставляется доступ с помощью этого назначения ролей. Идентификатор клиента для субъекта выводится с помощью клиента, связанного с подпиской.
properties.roleDefinitionId
  • string

Уникальный идентификатор связанного определения роли.
properties.scope
  • string

Путь к ресурсу плоскости данных, для которого предоставляется доступ с помощью этого назначения ролей.

Ответы

Name Type Description
200 OK

Операция создания или обновления назначения ролей успешно завершена.
202 Accepted

Запрос на создание или обновление назначения ролей был принят и будет выполняться асинхронно.
Other Status Codes

Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Flow OAuth2 Azure Active Directory

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

Scopes

Name Description
user_impersonation Олицетворение учетной записи пользователя

Примеры

CosmosDBSqlRoleAssignmentCreateUpdate

Sample Request

PUT https://management.azure.com/subscriptions/mySubscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/myAccountName/sqlRoleAssignments/myRoleAssignmentId?api-version=2021-04-01-preview

{
  "properties": {
    "roleDefinitionId": "/subscriptions/mySubscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/myAccountName/sqlRoleDefinitions/myRoleDefinitionId",
    "scope": "/subscriptions/mySubscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/myAccountName/dbs/purchases/colls/redmond-purchases",
    "principalId": "myPrincipalId"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/mySubscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/myAccountName/sqlRoleAssignments/myRoleAssignmentId",
  "name": "myRoleAssignmentId",
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlRoleAssignments",
  "properties": {
    "roleDefinitionId": "/subscriptions/mySubscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/myAccountName/sqlRoleDefinitions/myRoleDefinitionId",
    "scope": "/subscriptions/mySubscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/myAccountName/dbs/purchases/colls/redmond-purchases",
    "principalId": "myPrincipalId"
  }
}
Status code:
202

Определения

CloudError

Ответ об ошибке службы.
ErrorResponse

Ответ об ошибке.
SqlRoleAssignmentCreateUpdateParameters

Параметры для создания и обновления назначения ролей Cosmos базы данных Azure SQL.
SqlRoleAssignmentGetResults

Назначение ролей базы данных Cosmos Azure

CloudError

Ответ об ошибке службы.

Name Type Description
error

Ответ об ошибке.

ErrorResponse

Ответ об ошибке.

Name Type Description
code
  • string

Код ошибки.
message
  • string

Сообщение об ошибке, указывающее, почему операция завершилась сбоем.

SqlRoleAssignmentCreateUpdateParameters

Параметры для создания и обновления назначения ролей Cosmos базы данных Azure SQL.

Name Type Description
properties.principalId
  • string

Уникальный идентификатор связанного субъекта AAD в графе AAD, к которому предоставляется доступ с помощью этого назначения ролей. Идентификатор клиента для субъекта выводится с помощью клиента, связанного с подпиской.
properties.roleDefinitionId
  • string

Уникальный идентификатор связанного определения роли.
properties.scope
  • string

Путь к ресурсу плоскости данных, для которого предоставляется доступ с помощью этого назначения ролей.

SqlRoleAssignmentGetResults

Назначение ролей базы данных Cosmos Azure

Name Type Description
id
  • string

Уникальный идентификатор ресурса учетной записи базы данных.
name
  • string

Имя учетной записи базы данных.
properties.principalId
  • string

Уникальный идентификатор связанного субъекта AAD в графе AAD, к которому предоставляется доступ с помощью этого назначения ролей. Идентификатор клиента для субъекта выводится с помощью клиента, связанного с подпиской.
properties.roleDefinitionId
  • string

Уникальный идентификатор связанного определения роли.
properties.scope
  • string

Путь к ресурсу плоскости данных, для которого предоставляется доступ с помощью этого назначения ролей.
type
  • string

Тип ресурса Azure.