Managed Instance Administrators - Create Or Update

Ссылка

Служба:: SQL Database

Версия API:: 2021-11-01

Создает или обновляет администратора управляемого экземпляра.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	Имя управляемого экземпляра.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

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

Имя	Обязательно	Тип	Описание
properties.administratorType	True	ManagedInstanceAdministratorType	Тип администратора управляемого экземпляра.
properties.login	True	string	Имя входа администратора управляемого экземпляра.
properties.sid	True	string	SID (идентификатор объекта) администратора управляемого экземпляра.
properties.tenantId		string	Идентификатор клиента администратора управляемого экземпляра.

Ответы

Имя	Тип	Описание
200 OK	ManagedInstanceAdministrator	Администратор управляемого экземпляра успешно обновлен.
201 Created	ManagedInstanceAdministrator	Администратор управляемого экземпляра успешно создан.
202 Accepted		Принято
Other Status Codes		Ответы об ошибках: *** 400 InvalidManagedServerAdministratorType — недопустимый тип администратора, указанный в свойствах. 400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы. 400 InvalidManagedServerAzureADminDeleteOperation — пользователь пытался удалить управляемый сервер Azure Active Azure Admin, если задано значение AzureADOnlyAuthentication. Сначала используйте API azureADOnlyAuthentications. 400 InvalidManagedServerAADOnlyAuthTypePropertyName — управляемый сервер Azure Active Directory должен иметь тип проверки подлинности по умолчанию 400 InvalidParameterValue — параметру присвоено недопустимое значение. 400 InvalidLoginName — указано недопустимое имя входа. 400 PrincipalNotFoundInTenant — поиск AzureAD не вернул результаты для этого имени. 400 ServerPrincipalHasDuplicateDisplayNameInAad — поиск AzureAD вернул несколько результатов для этого имени. 400 ManagedInstanceIsBusy — Управляемый экземпляр занят другим запросом. 400 InvalidPrincipalType — этот тип субъекта не поддерживается в Базе данных Windows Azure SQL. 400 ServerPrincipalCreateLoginBadSyntax — при выполнении инструкции Create Login для Azure AD Administrator произошла синтаксическая ошибка. 400 ServicePrincipalLookupInAadFailed — сбой поиска AzureAD из-за ошибок инфраструктуры службы. 400 TenantNotFoundInActiveDirectory — клиент недоступен в Active Directory. 400 InvalidUsername — указанное имя пользователя содержит недопустимые символы. 400 ManagedInstanceHasNoPermissionsToAccessAad — попытка выполнить операцию, которая включает несуществующее имя входа или имя входа, для которого выполняющийся субъект не имеет разрешений. 403 ServicePrincipalLookupInAadFailedIdentityForbidden — поиск AzureAD завершился сбоем, так как MSI не были предоставлены разрешения на чтение в AAD. 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке. 404 ManagedInstanceNotInSubscriptionResourceGroup — указанный управляемый экземпляр не существует в указанной группе ресурсов и подписке. 404 SubscriptionNotFound — запрошенная подписка не найдена. 404 OperationIdNotFound — операция с идентификатором не существует. 404 ResourceNotFound — запрошенный ресурс не найден. 409 OperationCancelled — операция была отменена пользователем. 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом. 409 ServerPrincipalAlreadyExists — попытка создать субъект-сервер с неуникальным именем. 409 ServerPrincipalCurrentlyLoggedIn — пояснения. 409 ServerPrincipalOwnsJobs — попытка удалить имя входа, если у него есть активные задания. 409 ServerPrincipalIsGrantorOfPermissions — попытка удалить субъект-сервер, который является участником разрешений. 409 ServerPrincipalOwnsDatabase — изменение владельца баз данных перед удалением имени входа. 409 ServerPrincipalUsedInTriggerOrEventNotification — попытка удалить имя входа, которое используется в качестве контекста выполнения уведомления о триггере или событии. 409 ServerPrincipalOwnsObjects — попытка удалить имя входа, которому принадлежат объекты . 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию. 500 ActiveDirectoryLookupTimedOut — операция не может быть завершена в настоящее время. Повторите попытку позже. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами. 504 RequestTimeout — превышено допустимое время ожидания запроса на обслуживание.

Примеры

Create administrator of managed instance

Update administrator of managed instance

Create administrator of managed instance

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory?api-version=2021-11-01

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  }
}


import com.azure.resourcemanager.sql.fluent.models.ManagedInstanceAdministratorInner;
import com.azure.resourcemanager.sql.models.AdministratorName;
import com.azure.resourcemanager.sql.models.ManagedInstanceAdministratorType;
import java.util.UUID;

/**
 * Samples for ManagedInstanceAdministrators CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceAdministratorCreate.
     * json
     */
    /**
     * Sample code: Create administrator of managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAdministratorOfManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceAdministrators().createOrUpdate(
            "Default-SQL-SouthEastAsia", "managedInstance", AdministratorName.ACTIVE_DIRECTORY,
            new ManagedInstanceAdministratorInner()
                .withAdministratorType(ManagedInstanceAdministratorType.ACTIVE_DIRECTORY).withLogin("bob@contoso.com")
                .withSid(UUID.fromString("44444444-3333-2222-1111-000000000000")).withTenantId(
                    UUID.fromString("55555555-4444-3333-2222-111111111111")),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

Код состояния:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}

Код состояния:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}

Код состояния:: 202

Update administrator of managed instance

Образец запроса

HTTP
Java

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory?api-version=2021-11-01

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  }
}


import com.azure.resourcemanager.sql.fluent.models.ManagedInstanceAdministratorInner;
import com.azure.resourcemanager.sql.models.AdministratorName;
import com.azure.resourcemanager.sql.models.ManagedInstanceAdministratorType;
import java.util.UUID;

/**
 * Samples for ManagedInstanceAdministrators CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceAdministratorUpdate.
     * json
     */
    /**
     * Sample code: Update administrator of managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAdministratorOfManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceAdministrators().createOrUpdate(
            "Default-SQL-SouthEastAsia", "managedInstance", AdministratorName.ACTIVE_DIRECTORY,
            new ManagedInstanceAdministratorInner()
                .withAdministratorType(ManagedInstanceAdministratorType.ACTIVE_DIRECTORY).withLogin("bob@contoso.com")
                .withSid(UUID.fromString("44444444-3333-2222-1111-000000000000")).withTenantId(
                    UUID.fromString("55555555-4444-3333-2222-111111111111")),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

Код состояния:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}

Код состояния:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "44444444-3333-2222-1111-000000000000",
    "tenantId": "55555555-4444-3333-2222-111111111111"
  },
  "type": "Microsoft.Sql/managedInstances/administrators"
}

Код состояния:: 202

Определения

Имя	Описание
AdministratorName
ManagedInstanceAdministrator	Администратор управляемого экземпляра Azure SQL.
ManagedInstanceAdministratorType	Тип администратора управляемого экземпляра.

AdministratorName

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

ManagedInstanceAdministrator

Администратор управляемого экземпляра Azure SQL.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.administratorType	ManagedInstanceAdministratorType	Тип администратора управляемого экземпляра.
properties.login	string	Имя входа администратора управляемого экземпляра.
properties.sid	string	SID (идентификатор объекта) администратора управляемого экземпляра.
properties.tenantId	string	Идентификатор клиента администратора управляемого экземпляра.
type	string	Тип ресурса.

ManagedInstanceAdministratorType

Тип администратора управляемого экземпляра.

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

Поделиться через

Managed Instance Administrators - Create Or Update

Параметры URI

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

Ответы

Примеры

Create administrator of managed instance

Образец запроса

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

Update administrator of managed instance

Образец запроса

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

Определения

AdministratorName

ManagedInstanceAdministrator

ManagedInstanceAdministratorType

Дополнительные ресурсы