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 參數

名稱	位於	必要	類型	Description
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	受管理的執行個體名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。您可以從 Azure 資源管理員 API 或入口網站取得這個值。
subscriptionId	path	True	string	可識別 Azure 訂用帳戶的訂用帳戶識別碼。
api-version	query	True	string	要用於要求的 API 版本。

要求本文

名稱	必要	類型	Description
properties.administratorType	True	ManagedInstanceAdministratorType	受控實例管理員的類型。
properties.login	True	string	受控實例管理員的登入名稱。
properties.sid	True	string	受控實例管理員) SID (對象識別碼。
properties.tenantId		string	受控實例管理員的租用戶標識碼。

回應

名稱	類型	Description
200 OK	ManagedInstanceAdministrator	已成功更新受控實例管理員。
201 Created	ManagedInstanceAdministrator	已成功建立受控實例管理員。
202 Accepted		已接受
Other Status Codes		錯誤回應： ≦ 400 InvalidManagedServerAdministratorType - 屬性中指定的系統管理員類型無效。 400 InvalidResourceRequestBody - 要求本文中的資源或資源屬性是空的或無效的。 400 InvalidManagedServerAzureADAdminDeleteOperation - 使用者嘗試在設定 AzureADOnlyAuthentication 時刪除受控伺服器 Azure Active Azure 系統管理員，請先使用 azureADOnlyAuthentications API。 400 InvalidManagedServerAADOnlyAuthTypePropertyName - 僅限受控伺服器 Azure Active Directory 驗證類型應該是預設值 400 InvalidParameterValue - 已將無效的值提供給參數。 400 InvalidLoginName - 提供的登入名稱無效。 400 PrincipalNotFoundInTenant - AzureAD Lookup 未傳回此名稱的結果。 400 ServerPrincipalHasDuplicateDisplayNameInAad - AzureAD Lookup 傳回此名稱的多個結果。 400 ManagedInstanceIsBusy - 受控執行個體正忙於另一個要求。 400 InvalidPrincipalType - Windows Azure SQL Database 不支援此主體類型。 400 ServerPrincipalCreateLoginBadSyntax - 執行 Azure AD 系統管理員的建立登入語句時發生語法錯誤。 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

定義

名稱	Description
AdministratorName
ManagedInstanceAdministrator	Azure SQL 受控實例管理員。
ManagedInstanceAdministratorType	受控實例管理員的類型。

AdministratorName

名稱	類型	Description
ActiveDirectory	string

ManagedInstanceAdministrator

Azure SQL 受控實例管理員。

名稱	類型	Description
id	string	資源識別碼。
name	string	資源名稱。
properties.administratorType	ManagedInstanceAdministratorType	受控實例管理員的類型。
properties.login	string	受控實例管理員的登入名稱。
properties.sid	string	受控實例管理員) SID (對象識別碼。
properties.tenantId	string	受控實例管理員的租用戶標識碼。
type	string	資源類型。

ManagedInstanceAdministratorType

受控實例管理員的類型。

名稱	類型	Description
ActiveDirectory	string

共用方式為

Managed Instance Administrators - Create Or Update

URI 參數

要求本文

回應

範例

Create administrator of managed instance

範例要求

範例回覆

Update administrator of managed instance

範例要求

範例回覆

定義

AdministratorName

ManagedInstanceAdministrator

ManagedInstanceAdministratorType

其他資源