Server Azure AD Administrators - Create Or Update

Reference

Služba:: SQL Database

Verze rozhraní API:: 2021-11-01

Vytvoří nebo aktualizuje existujícího správce Azure Active Directory.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
administratorName	path	True	AdministratorName	Název správce active directory serveru.
resourceGroupName	path	True	string	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Vyžadováno	Typ	Description
properties.administratorType	True	AdministratorType	Typ správce serveru.
properties.login	True	string	Přihlašovací jméno správce serveru.
properties.sid	True	string	IDENTIFIKÁTOR SID (ID objektu) správce serveru.
properties.tenantId		string	ID tenanta správce.

Odpovědi

Name	Typ	Description
200 OK	ServerAzureADAdministrator	Správce Azure Active Directory se úspěšně aktualizoval.
201 Created	ServerAzureADAdministrator	Správce Azure Active Directory se úspěšně vytvořil.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 InvalidServerAdministratorTypePropertyName – Typ správce active directory serveru by měl být ActiveDirectory. 400 InvalidResourceRequestBody – prostředek nebo vlastnosti prostředku v textu požadavku jsou prázdné nebo neplatné. 400 InvalidServerAzureADOnlyAuthenticationParameter – Uživatel se pokusil nastavit parametr AzureADOnlyAuthentication na hodnotu false, což není povoleno. Použijte místo toho rozhraní API azureADOnlyAuthentications. 400 InvalidServerAzureADAdminDeleteOperation – Uživatel se při nastavení AzureADOnlyAuthentication pokusil odstranit serverového správce Azure Active Azure. Nejprve použijte rozhraní API azureADOnlyAuthentications. 400 ServerAdministratorNameAlreadyExists – uživatel se pokusil nastavit externího správce a hlavní název již existuje v hlavní databázi. 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel. 404 ServerNotInSubscriptionResourceGroup – zadaný server v zadané skupině prostředků a předplatném neexistuje. 404 OperationIdNotFound – operace s ID neexistuje. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

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

Ukázková odpověď

Stavový kód:: 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
  }
}

Stavový kód:: 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
  }
}

Stavový kód:: 202

Definice

Name	Description
AdministratorName	Název správce active directory serveru.
AdministratorType	Typ správce serveru.
ServerAzureADAdministrator	Správce Azure Active Directory.

AdministratorName

Název správce active directory serveru.

Name	Typ	Description
ActiveDirectory	string

AdministratorType

Typ správce serveru.

Name	Typ	Description
ActiveDirectory	string

ServerAzureADAdministrator

Správce Azure Active Directory.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.administratorType	AdministratorType	Typ správce serveru.
properties.azureADOnlyAuthentication	boolean	Povolené ověřování pouze v Azure Active Directory.
properties.login	string	Přihlašovací jméno správce serveru.
properties.sid	string	IDENTIFIKÁTOR SID (ID objektu) správce serveru.
properties.tenantId	string	ID tenanta správce.
type	string	Typ prostředku.

Sdílet prostřednictvím