Server Azure AD Administrators - Create Or Update
Создаёт или обновляет существующий администратор Azure Active Directory.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/administrators/ActiveDirectory?api-version=2025-01-01
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
administrator
|
path | True |
Имя администратора Active Directory сервера. |
|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя регистронезависимо. |
|
server
|
path | True |
string |
Имени сервера. |
|
subscription
|
path | True |
string (uuid) |
Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID). |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Текст запроса
| Имя | Обязательно | Тип | Описание |
|---|---|---|---|
| properties.login | True |
string |
Имя входа администратора сервера. |
| properties.sid | True |
string (uuid) |
ИДЕНТИФИКАТОР безопасности (идентификатор объекта) администратора сервера. |
| properties.administratorType |
Тип администратора развера. |
||
| properties.tenantId |
string (uuid) |
Идентификатор клиента администратора. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Операция обновления ресурса 'ServerAzureADAdministrator' успешно |
|
| 201 Created |
Resource 'ServerAzureADAdministrator' операция create успешно Заголовки
|
|
| 202 Accepted |
Операция ресурса принята. Заголовки
|
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | олицетворения учетной записи пользователя |
Примеры
Creates or updates an existing Azure Active Directory administrator.
Образец запроса
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory?api-version=2025-01-01
{
"properties": {
"administratorType": "ActiveDirectory",
"login": "bob@contoso.com",
"sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
"tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
}
}
Пример ответа
{
"name": "ActiveDirectory",
"type": "Microsoft.Sql/servers/administrators",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
"properties": {
"administratorType": "ActiveDirectory",
"azureADOnlyAuthentication": true,
"login": "bob@contoso.com",
"sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
"tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
}
}
{
"name": "activeDirectory",
"type": "Microsoft.Sql/servers/administrators",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
"properties": {
"administratorType": "ActiveDirectory",
"azureADOnlyAuthentication": true,
"login": "bob@contoso.com",
"sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
"tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
}
}
Определения
| Имя | Описание |
|---|---|
|
Administrator |
Имя администратора Active Directory сервера. |
|
Administrator |
Тип администратора развера. |
|
created |
Тип удостоверения, создавшего ресурс. |
|
Error |
Ошибка управления ресурсами дополнительная информация. |
|
Error |
Детали ошибки. |
|
Error |
Ответ на ошибку |
|
Server |
Azure Active Directory administrator. |
|
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
AdministratorName
Имя администратора Active Directory сервера.
| Значение | Описание |
|---|---|
| ActiveDirectory |
Служба ActiveDirectory |
AdministratorType
Тип администратора развера.
| Значение | Описание |
|---|---|
| ActiveDirectory |
Служба ActiveDirectory |
createdByType
Тип удостоверения, создавшего ресурс.
| Значение | Описание |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Ошибка управления ресурсами дополнительная информация.
| Имя | Тип | Описание |
|---|---|---|
| info |
object |
Дополнительная информация. |
| type |
string |
Тип дополнительной информации. |
ErrorDetail
Детали ошибки.
| Имя | Тип | Описание |
|---|---|---|
| additionalInfo |
Ошибка дополнительная информация. |
|
| code |
string |
Код ошибки. |
| details |
Сведения об ошибке. |
|
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект ошибки. |
ErrorResponse
Ответ на ошибку
| Имя | Тип | Описание |
|---|---|---|
| error |
Объект ошибки. |
ServerAzureADAdministrator
Azure Active Directory administrator.
| Имя | Тип | Описание |
|---|---|---|
| id |
string (arm-id) |
Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Имя ресурса |
| properties.administratorType |
Тип администратора развера. |
|
| properties.azureADOnlyAuthentication |
boolean |
Azure Active Directory only Authentication включена. |
| properties.login |
string |
Имя входа администратора сервера. |
| properties.sid |
string (uuid) |
ИДЕНТИФИКАТОР безопасности (идентификатор объекта) администратора сервера. |
| properties.tenantId |
string (uuid) |
Идентификатор клиента администратора. |
| systemData |
Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy. |
|
| type |
string |
Тип ресурса. Например, «Microsoft. Compute/virtualMachines» или «Microsoft. Аккаунты хранения/хранения» |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
| Имя | Тип | Описание |
|---|---|---|
| createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
| createdBy |
string |
Удостоверение, создающее ресурс. |
| createdByType |
Тип удостоверения, создавшего ресурс. |
|
| lastModifiedAt |
string (date-time) |
Временная метка последнего изменения ресурса (UTC) |
| lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
| lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |