Server Azure AD Administrators - Create Or Update

Referenz

Dienst:: SQL Database

API-Version:: 2021-11-01

Erstellt oder aktualisiert einen vorhandenen Azure Active Directory-Administrator.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
administratorName	path	True	AdministratorName	Der Name des Active Directory-Serveradministrators.
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.
serverName	path	True	string	Name des Servers
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	AdministratorType	Typ des Serveradministrators.
properties.login	True	string	Anmeldename des Serveradministrators.
properties.sid	True	string	SID (Objekt-ID) des Serveradministrators.
properties.tenantId		string	Mandanten-ID des Administrators.

Antworten

Name	Typ	Beschreibung
200 OK	ServerAzureADAdministrator	Ein Azure Active Directory-Administrator wurde erfolgreich aktualisiert.
201 Created	ServerAzureADAdministrator	Ein Azure Active Directory-Administrator wurde erfolgreich erstellt.
202 Accepted		Akzeptiert
Other Status Codes		Fehlerantworten: *** 400 InvalidServerAdministratorTypePropertyName: Active Directory-Administratortyp des Servers sollte ActiveDirectory sein. 400 InvalidResourceRequestBody: Die Ressourcen- oder Ressourceneigenschaften im Anforderungstext sind leer oder ungültig. 400 InvalidServerAzureADOnlyAuthenticationParameter: Der Benutzer hat versucht, den AzureADOnlyAuthentication-Parameter auf false festzulegen, was nicht zulässig ist. Verwenden Sie stattdessen die AZUREADOnlyAuthentications-API. 400 InvalidServerAzureADAdminDeleteOperation : Benutzer hat versucht, server Azure Active Azure admin zu löschen, wenn AzureADOnlyAuthentication festgelegt ist. Verwenden Sie zuerst die azureADOnlyAuthentications-API. 400 ServerAdministratorNameAlreadyExists: Der Benutzer hat versucht, den externen Administrator festzulegen, und der Prinzipalname ist bereits in der Datenbank "master" vorhanden. 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden. 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 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. 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: Timeout des Vorgangs und automatisches Rollback. Wiederholen Sie den Vorgang. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Creates or updates an existing Azure Active Directory administrator.

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory?api-version=2021-11-01

{
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"
  }
}


import com.azure.resourcemanager.sql.fluent.models.ServerAzureADAdministratorInner;
import com.azure.resourcemanager.sql.models.AdministratorName;
import com.azure.resourcemanager.sql.models.AdministratorType;
import java.util.UUID;

/**
 * Samples for ServerAzureADAdministrators CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/AdministratorCreateOrUpdate.json
     */
    /**
     * Sample code: Creates or updates an existing Azure Active Directory administrator.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createsOrUpdatesAnExistingAzureActiveDirectoryAdministrator(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAzureADAdministrators().createOrUpdate("sqlcrudtest-4799",
            "sqlcrudtest-6440", AdministratorName.ACTIVE_DIRECTORY,
            new ServerAzureADAdministratorInner().withAdministratorType(AdministratorType.ACTIVE_DIRECTORY)
                .withLogin("bob@contoso.com").withSid(UUID.fromString("c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c"))
                .withTenantId(UUID.fromString("c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c")),
            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/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
  "name": "ActiveDirectory",
  "type": "Microsoft.Sql/servers/administrators",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "azureADOnlyAuthentication": true
  }
}

Statuscode:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-6440/administrators/ActiveDirectory",
  "name": "activeDirectory",
  "type": "Microsoft.Sql/servers/administrators",
  "properties": {
    "administratorType": "ActiveDirectory",
    "login": "bob@contoso.com",
    "sid": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "tenantId": "c6b82b90-a647-49cb-8a62-0d2d3cb7ac7c",
    "azureADOnlyAuthentication": true
  }
}

Statuscode:: 202

Definitionen

Name	Beschreibung
AdministratorName	Der Name des Active Directory-Serveradministrators.
AdministratorType	Typ des Serveradministrators.
ServerAzureADAdministrator	Azure Active Directory-Administrator

AdministratorName

Der Name des Active Directory-Serveradministrators.

Name	Typ	Beschreibung
ActiveDirectory	string

AdministratorType

Typ des Serveradministrators.

Name	Typ	Beschreibung
ActiveDirectory	string

ServerAzureADAdministrator

Azure Active Directory-Administrator

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.administratorType	AdministratorType	Typ des Serveradministrators.
properties.azureADOnlyAuthentication	boolean	Nur Azure Active Directory-Authentifizierung aktiviert.
properties.login	string	Anmeldename des Serveradministrators.
properties.sid	string	SID (Objekt-ID) des Serveradministrators.
properties.tenantId	string	Mandanten-ID des Administrators.
type	string	Der Ressourcentyp.

Freigeben über