Managed Instance Administrators - Create Or Update

참조

서비스:: SQL Database

API 버전:: 2021-11-01

관리되는 instance 관리자를 만들거나 업데이트합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	관리되는 인스턴스의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	필수	형식	Description
properties.administratorType	True	ManagedInstanceAdministratorType	관리되는 instance 관리자의 유형입니다.
properties.login	True	string	관리되는 instance 관리자의 로그인 이름입니다.
properties.sid	True	string	관리되는 instance 관리자의 SID(개체 ID)입니다.
properties.tenantId		string	관리되는 instance 관리자의 테넌트 ID입니다.

응답

Name	형식	Description
200 OK	ManagedInstanceAdministrator	관리되는 instance 관리자를 업데이트했습니다.
201 Created	ManagedInstanceAdministrator	관리되는 instance 관리자를 만들었습니다.
202 Accepted		수락됨
Other Status Codes		오류 응답: *** 400 InvalidManagedServerAdministratorType - 속성에 지정된 잘못된 관리자 유형입니다. 400 InvalidResourceRequestBody - 요청 본문의 리소스 또는 리소스 속성이 비어 있거나 잘못되었습니다. 400 InvalidManagedServerAzureADminDeleteOperation - AzureADOnlyAuthentication이 설정된 경우 사용자가 관리되는 서버 Azure Active Azure 관리자를 삭제하려고 했습니다. 먼저 azureADOnlyAuthentications API를 사용하세요. 400 InvalidManagedServerAADOnlyAuthTypePropertyName - 관리되는 서버 Azure Active Directory 전용 인증 유형은 기본값이어야 합니다. 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다. 400 InvalidLoginName - 제공된 로그인 이름이 잘못되었습니다. 400 PrincipalNotFoundInTenant - AzureAD 조회는 이 이름에 대한 결과를 반환하지 않았습니다. 400 ServerPrincipalHasDuplicateDisplayNameInAad - AzureAD 조회는 이 이름에 대해 여러 결과를 반환했습니다. 400 ManagedInstanceIsBusy - Managed Instance 다른 요청으로 사용 중입니다. 400 InvalidPrincipalType - 이 보안 주체 유형은 Windows Azure SQL 데이터베이스에서 지원되지 않습니다. 400 ServerPrincipalCreateLoginBadSyntax - Azure AD Administrator에 대한 로그인 만들기 문을 실행할 때 구문 오류가 발생했습니다. 400 ServicePrincipalLookupInAadFailed - 서비스 인프라 오류로 인해 AzureAD 조회가 실패했습니다. 400 TenantNotFoundInActiveDirectory - 테넌트는 Active Directory에서 사용할 수 없습니다. 400 InvalidUsername - 제공된 사용자 이름에 잘못된 문자가 포함되어 있습니다. 400 ManagedInstanceHasNoPermissionsToAccessAad - 실행 주체에 권한이 없는 기존 로그인 또는 로그인이 포함된 작업을 수행하려고 시도합니다. 403 ServicePrincipalLookupInAadFailedIdentityForbidden - MSI에 AAD에 대한 읽기 권한이 부여되지 않아 AzureAD 조회가 실패했습니다. 404 ServerNotInSubscription - 지정된 서버가 지정된 구독에 없습니다. 404 ManagedInstanceNotInSubscriptionResourceGroup - 지정된 관리되는 instance 지정된 리소스 그룹 및 구독에 없습니다. 404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 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

정의

Name	Description
AdministratorName
ManagedInstanceAdministrator	Azure SQL 관리되는 instance 관리자입니다.
ManagedInstanceAdministratorType	관리되는 instance 관리자의 유형입니다.

AdministratorName

Name	형식	Description
ActiveDirectory	string

ManagedInstanceAdministrator

Azure SQL 관리되는 instance 관리자입니다.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.administratorType	ManagedInstanceAdministratorType	관리되는 instance 관리자의 유형입니다.
properties.login	string	관리되는 instance 관리자의 로그인 이름입니다.
properties.sid	string	관리되는 instance 관리자의 SID(개체 ID)입니다.
properties.tenantId	string	관리되는 instance 관리자의 테넌트 ID입니다.
type	string	리소스 종류.

ManagedInstanceAdministratorType

관리되는 instance 관리자의 유형입니다.

Name	형식	Description
ActiveDirectory	string

다음을 통해 공유

Managed Instance Administrators - Create Or Update

URI 매개 변수

요청 본문

응답

예제

Create administrator of managed instance

샘플 요청

샘플 응답

Update administrator of managed instance

샘플 요청

샘플 응답

정의

AdministratorName

ManagedInstanceAdministrator

ManagedInstanceAdministratorType

추가 리소스