Server Azure AD Administrators - Create Or Update

  • Ссылка
Служба:
SQL Database
Версия API:
2021-11-01

Создает или обновляет существующего администратора Azure Active Directory.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/administrators/ActiveDirectory?api-version=2021-11-01

Параметры URI

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

AdministratorName

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

string

Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
serverName
 path True

string

Имя сервера.
subscriptionId
 path True

string

Идентификатор подписки Azure.
api-version
 query True

string

Версия API для использования в запросе.

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

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

AdministratorType

Тип администратора серверов.
properties.login True

string

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

string

SID (идентификатор объекта) администратора сервера.
properties.tenantId

string

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

Ответы

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

ServerAzureADAdministrator

Администратор Azure Active Directory успешно обновлен.
201 Created

ServerAzureADAdministrator

Администратор Azure Active Directory успешно создан.
202 Accepted

Принято
Other Status Codes

Ответы об ошибках: ***

  • 400 InvalidServerAdministratorTypePropertyName — тип администратора Active Directory сервера должен иметь значение ActiveDirectory

  • 400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы.

  • 400 InvalidServerAzureADOnlyAuthenticationParameter — пользователь попытался задать для параметра AzureADOnlyAuthentication значение false, что не разрешено. Вместо этого используйте API azureADOnlyAuthentications.

  • 400 InvalidServerAzureADminDeleteOperation — пользователь пытался удалить сервер Azure Active Azure Admin, если задано значение AzureADOnlyAuthentication. Сначала используйте API azureADOnlyAuthentications.

  • 400 ServerAdministratorNameAlreadyExists — пользователь попытался задать внешнего администратора, и имя субъекта уже существует в базе данных master.

  • 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден.

  • 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

  • 404 OperationIdNotFound — операция с идентификатором не существует.

  • 409 OperationCancelled — операция была отменена пользователем.

  • 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом.

  • 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами.

  • 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию.

  • 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами.

Примеры

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=2021-11-01

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
  }
}

Пример ответа

Код состояния:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "type": "Microsoft.Sql/servers/administrators",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "azureADOnlyAuthentication": true
  }
}
Код состояния:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
  "name": "activeDirectory",
  "type": "Microsoft.Sql/servers/administrators",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "azureADOnlyAuthentication": true
  }
}
Код состояния:
202

Определения

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

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

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

администратор Azure Active Directory;

AdministratorName

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

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

string

AdministratorType

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

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

string

ServerAzureADAdministrator

администратор Azure Active Directory;

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

string

Идентификатор ресурса.
name

string

Имя ресурса.
properties.administratorType

AdministratorType

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

boolean

Включена только проверка подлинности Azure Active Directory.
properties.login

string

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

string

SID (идентификатор объекта) администратора сервера.
properties.tenantId

string

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

string

Тип ресурса.