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

Имя В Обязательно Тип Описание
administratorName
path True

AdministratorName

Имя администратора Active Directory сервера.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя регистронезависимо.

serverName
path True

string

Имени сервера.

subscriptionId
path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).

api-version
query True

string

minLength: 1

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

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

Имя Обязательно Тип Описание
properties.login True

string

Имя входа администратора сервера.

properties.sid True

string (uuid)

ИДЕНТИФИКАТОР безопасности (идентификатор объекта) администратора сервера.

properties.administratorType

AdministratorType

Тип администратора развера.

properties.tenantId

string (uuid)

Идентификатор клиента администратора.

Ответы

Имя Тип Описание
200 OK

ServerAzureADAdministrator

Операция обновления ресурса 'ServerAzureADAdministrator' успешно

201 Created

ServerAzureADAdministrator

Resource 'ServerAzureADAdministrator' операция create успешно

Заголовки

  • Location: string
  • Retry-After: integer
202 Accepted

Операция ресурса принята.

Заголовки

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

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

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"
  }
}

Определения

Имя Описание
AdministratorName

Имя администратора Active Directory сервера.

AdministratorType

Тип администратора развера.

createdByType

Тип удостоверения, создавшего ресурс.

ErrorAdditionalInfo

Ошибка управления ресурсами дополнительная информация.

ErrorDetail

Детали ошибки.

ErrorResponse

Ответ на ошибку

ServerAzureADAdministrator

Azure Active Directory administrator.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

AdministratorName

Имя администратора Active Directory сервера.

Значение Описание
ActiveDirectory

Служба ActiveDirectory

AdministratorType

Тип администратора развера.

Значение Описание
ActiveDirectory

Служба ActiveDirectory

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Ошибка управления ресурсами дополнительная информация.

Имя Тип Описание
info

object

Дополнительная информация.

type

string

Тип дополнительной информации.

ErrorDetail

Детали ошибки.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Ошибка дополнительная информация.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

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

ServerAzureADAdministrator

Azure Active Directory administrator.

Имя Тип Описание
id

string (arm-id)

Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Имя ресурса

properties.administratorType

AdministratorType

Тип администратора развера.

properties.azureADOnlyAuthentication

boolean

Azure Active Directory only Authentication включена.

properties.login

string

Имя входа администратора сервера.

properties.sid

string (uuid)

ИДЕНТИФИКАТОР безопасности (идентификатор объекта) администратора сервера.

properties.tenantId

string (uuid)

Идентификатор клиента администратора.

systemData

systemData

Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy.

type

string

Тип ресурса. Например, «Microsoft. Compute/virtualMachines» или «Microsoft. Аккаунты хранения/хранения»

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Временная метка последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.