Managed Instance Administrators - Delete

服務:

SQL Database

API 版本:

2023-08-01

刪除受控實例管理員。

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

URI 參數

名稱	位於	必要	類型	Description
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	受控實例的名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。 您可以從 Azure Resource Manager API 或入口網站取得此值。
subscriptionId	path	True	string	識別 Azure 訂用帳戶的訂用帳戶標識碼。
api-version	query	True	string	要用於要求的 API 版本。

回應

名稱	類型	Description
200 OK		已成功刪除受控實例管理員。
202 Accepted		接受 標題 Location: string
Other Status Codes	ErrorResponse	錯誤回應： *** 400 SubnetMissingRequiredDelegation - SQL 受控實例不會委派選取的子網。 400 InvalidManagedServerAdministratorType - 屬性中指定的系統管理員類型無效。 400 InvalidResourceRequestBody - 要求主體中的資源或資源屬性是空的或無效的。 400 InvalidManagedServerAzureADAdminDeleteOperation - 使用者嘗試在設定 AzureADOnlyAuthentication 時刪除受控伺服器 Azure Active Azure 系統管理員，請先使用 azureADOnlyAuthentications API。 400 InvalidManagedServerAADOnlyAuthTypePropertyName - 受控伺服器 Azure Active Directory 僅限驗證類型應該是預設值 400 ServerPrincipalCreateLoginBadSyntax - 執行 Azure AD 系統管理員的建立登入語句時發生語法錯誤。 400 ManagedInstanceIsBusy - 受控實例正忙於另一個要求。 400 InvalidLoginName - 提供的登入名稱無效。 400 ServicePrincipalLookupInAadFailedIdentityForbidden - AzureAD 查閱失敗，因為 MSI 未授與 AAD 的讀取許可權。 400 PrincipalNotFoundInTenant - AzureAD Lookup 未傳回此名稱的結果。 400 ServerPrincipalHasDuplicateDisplayNameInAad - AzureAD Lookup 傳回此名稱的多個結果。 400 InvalidPrincipalType - Windows Azure SQL Database 不支援此主體類型。 400 InvalidParameterValue - 為參數指定了無效的值。 400 ServicePrincipalLookupInAadFailed - AzureAD 查閱因服務基礎結構錯誤而失敗。 400 TenantNotFoundInActiveDirectory - Active Directory 中無法使用租使用者。 400 InvalidUsername - 提供的使用者名稱包含無效的字元。 400 ManagedInstanceHasNoPermissionsToAccessAad - 嘗試執行作業，這牽涉到執行主體沒有許可權的非現有登入或登入。 404 ManagedInstanceNotInSubscriptionResourceGroup - 指定的受控實例不存在於指定的資源群組和訂用帳戶中。 404 SubscriptionNotFound - 找不到要求的訂用帳戶。 404 ServerNotInSubscription - 指定的伺服器不存在於指定的訂用帳戶上。 404 OperationIdNotFound - 標識符為 的作業不存在。 404 ResourceNotFound - 找不到要求的資源。 409 CannotCancelOperation - 管理作業處於無法取消的狀態。 409 OperationCancelled - 使用者已取消作業。 409 OperationInterrupted - 無法完成資源上的作業，因為相同資源上的另一個作業中斷。 409 ServerPrincipalOwnsJobs - 嘗試在具有作用中作業時移除登入。 409 ServerPrincipalOwnsObjects - 嘗試卸除擁有 物件的登入。 409 ServerPrincipalIsGrantorOfPermissions - 嘗試卸除伺服器主體，這是許可權的授出席者。 409 ServerPrincipalOwnsDatabase - 在卸除登入之前變更資料庫的擁有者。 409 ServerPrincipalCurrentlyLoggedIn - 自我說明。 409 ServerPrincipalAlreadyExists - 嘗試建立具有非唯一名稱的伺服器主體。 409 ServerPrincipalUsedInTriggerOrEventNotification - 嘗試卸除登入，該登入會當做觸發程式或事件通知的執行內容使用。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理之最大要求的要求。 500 OperationTimedOut - 作業逾時並自動回復。 請重試作業。 500 ActiveDirectoryLookupTimedOut - 目前無法完成作業。 請稍後再試一次。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。 504 RequestTimeout - 服務要求超過允許的逾時。

範例

Delete administrator of managed instance

範例要求

HTTP

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ManagedInstanceAdministratorDelete.json
// this example is just showing the usage of "ManagedInstanceAdministrators_Delete" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ManagedInstanceAdministratorResource created on azure
// for more information of creating ManagedInstanceAdministratorResource, please refer to the document of ManagedInstanceAdministratorResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string managedInstanceName = "managedInstance";
SqlAdministratorName administratorName = SqlAdministratorName.ActiveDirectory;
ResourceIdentifier managedInstanceAdministratorResourceId = ManagedInstanceAdministratorResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, managedInstanceName, administratorName);
ManagedInstanceAdministratorResource managedInstanceAdministrator = client.GetManagedInstanceAdministratorResource(managedInstanceAdministratorResourceId);

// invoke the operation
await managedInstanceAdministrator.DeleteAsync(WaitUntil.Completed);

Console.WriteLine("Succeeded");

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

範例回覆

狀態碼:

200

狀態碼:

202

Location: https://management.azure.com/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/managedinstanceadministratorazureasyncoperation/00000000-1111-2222-3333-444444444444?api-version=2022-11-01-preview

定義

名稱	Description
AdministratorName
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應

AdministratorName

列舉型別

值	Description
ActiveDirectory

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。