Managed Instance Administrators - Create Or Update

Referenz

Dienst:: SQL Database

API-Version:: 2021-11-01

Erstellt oder aktualisiert einen verwalteten instance-Administrator.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	Der Name der verwalteten Instanz.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.administratorType	True	ManagedInstanceAdministratorType	Typ des verwalteten instance-Administrators.
properties.login	True	string	Anmeldename des verwalteten instance Administrators.
properties.sid	True	string	SID (Objekt-ID) des verwalteten instance Administrators.
properties.tenantId		string	Mandanten-ID des verwalteten instance Administrators.

Antworten

Name	Typ	Beschreibung
200 OK	ManagedInstanceAdministrator	Der verwaltete instance-Administrator wurde erfolgreich aktualisiert.
201 Created	ManagedInstanceAdministrator	Der verwaltete instance-Administrator wurde erfolgreich erstellt.
202 Accepted		Akzeptiert
Other Status Codes		Fehlerantworten: *** 400 InvalidManagedServerAdministratorType: Ungültiger Administratortyp, der in den Eigenschaften angegeben ist. 400 InvalidResourceRequestBody: Die Ressourcen- oder Ressourceneigenschaften im Anforderungstext sind leer oder ungültig. 400 InvalidManagedServerAzureADAdminDeleteOperation: Benutzer haben versucht, verwalteten Server zu löschen Azure Active Azure-Administrator, wenn AzureADOnlyAuthentication festgelegt ist. Verwenden Sie zuerst die azureADOnlyAuthentications-API. 400 InvalidManagedServerAADOnlyAuthTypePropertyName: Der Authentifizierungstyp nur für verwaltete Azure Active Directory sollte Standard sein. 400 InvalidParameterValue: Einem Parameter wurde ein ungültiger Wert zugewiesen. 400 InvalidLoginName: Der angegebene Anmeldename ist ungültig. 400 PrincipalNotFoundInTenant : AzureAD-Lookup hat keine Ergebnisse für diesen Namen zurückgegeben. 400 ServerPrincipalHasDuplicateDisplayNameInAad : AzureAD Lookup hat mehrere Ergebnisse für diesen Namen zurückgegeben. 400 ManagedInstanceIsBusy: verwaltete Instanz ist mit einer anderen Anforderung beschäftigt. 400 InvalidPrincipalType: Dieser Prinzipaltyp wird in Windows Azure SQL-Datenbank nicht unterstützt. 400 ServerPrincipalCreateLoginBadSyntax: Beim Ausführen der Create Login-Anweisung für Den Azure AD-Administrator ist ein Syntaxfehler aufgetreten. 400 ServicePrincipalLookupInAadFailed: Fehler beim AzureAD-Lookup aufgrund von Dienstinfrastrukturfehlern. 400 TenantNotFoundInActiveDirectory: Der Mandant ist in Active Directory nicht verfügbar. 400 InvalidUsername: Der angegebene Benutzername enthält ungültige Zeichen. 400 ManagedInstanceHasNoPermissionsToAccessAad : Versucht, einen Vorgang auszuführen, der eine nicht vorhandene Anmeldung oder Anmeldung beinhaltet, für die der ausführende Prinzipal über keine Berechtigungen verfügt. 403 ServicePrincipalLookupInAadFailedIdentityForbidden: Fehler bei der AzureAD-Suche, weil MSI keine Leseberechtigungen für AAD erteilt wurden. 404 ServerNotInSubscription: Der angegebene Server ist im angegebenen Abonnement nicht vorhanden. 404 ManagedInstanceNotInSubscriptionResourceGroup: Die angegebene verwaltete instance ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 SubscriptionNotFound: Das angeforderte Abonnement wurde nicht gefunden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 409 ServerPrincipalAlreadyExists: Versuchen Sie, einen Serverprinzipal mit einem nicht eindeutigen Namen zu erstellen. 409 ServerPrincipalCurrentlyLoggedIn – Selbsterklärend. 409 ServerPrincipalOwnsJobs: Versucht, eine Anmeldung zu entfernen, wenn aktive Aufträge vorhanden sind. 409 ServerPrincipalIsGrantorOfPermissions: Versuchen Sie, einen Serverprinzipal zu löschen, der ein Berechtigungsempfänger ist. 409 ServerPrincipalOwnsDatabase: Ändern Sie den Besitzer der Datenbank(en), bevor Sie die Anmeldung löschen. 409 ServerPrincipalUsedInTriggerOrEventNotification: Versuch, die Anmeldung zu löschen, die als Ausführungskontext eines Triggers oder einer Ereignisbenachrichtigung verwendet wird. 409 ServerPrincipalOwnsObjects: Versuchen Sie, eine Anmeldung zu löschen, die Objekte besitzt. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut: Der Vorgang ist timeout und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang. 500 ActiveDirectoryLookupTimedOut: Der Vorgang konnte zu diesem Zeitpunkt nicht abgeschlossen werden. Versuchen Sie es später noch mal. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 504 RequestTimeout: Die Dienstanforderung hat das zulässige Timeout überschritten.

Beispiele

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

Beispiel für eine Antwort

Statuscode:: 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"
}

Statuscode:: 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"
}

Statuscode:: 202

Update administrator of managed instance

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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"
}

Statuscode:: 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"
}

Statuscode:: 202

Definitionen

Name	Beschreibung
AdministratorName
ManagedInstanceAdministrator	Ein Azure SQL verwalteter instance-Administrator.
ManagedInstanceAdministratorType	Typ des verwalteten instance-Administrators.

AdministratorName

Name	Typ	Beschreibung
ActiveDirectory	string

ManagedInstanceAdministrator

Ein Azure SQL verwalteter instance-Administrator.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.administratorType	ManagedInstanceAdministratorType	Typ des verwalteten instance-Administrators.
properties.login	string	Anmeldename des verwalteten instance Administrators.
properties.sid	string	SID (Objekt-ID) des verwalteten instance Administrators.
properties.tenantId	string	Mandanten-ID des verwalteten instance Administrators.
type	string	Der Ressourcentyp.

ManagedInstanceAdministratorType

Typ des verwalteten instance-Administrators.

Name	Typ	Beschreibung
ActiveDirectory	string

Freigeben über

Managed Instance Administrators - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Beispiele

Create administrator of managed instance

Beispielanforderung

Beispiel für eine Antwort

Update administrator of managed instance

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AdministratorName

ManagedInstanceAdministrator

ManagedInstanceAdministratorType

Zusätzliche Ressourcen