Server Azure AD Administrators - Create Or Update

Referencia

Servicio:: SQL Database

Versión de la API:: 2021-11-01

Crea o actualiza un administrador de Azure Active Directory existente.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
administratorName	path	True	AdministratorName	Nombre del administrador de Active Directory del servidor.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.
serverName	path	True	string	Nombre del servidor.
subscriptionId	path	True	string	Identificador de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	Versión de la API que se va a usar para la solicitud.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.administratorType	True	AdministratorType	Tipo del administrador del servidor.
properties.login	True	string	Nombre de inicio de sesión del administrador del servidor.
properties.sid	True	string (uuid)	SID (id. de objeto) del administrador del servidor.
properties.tenantId		string (uuid)	Identificador de inquilino del administrador.

Respuestas

Nombre	Tipo	Description
200 OK	ServerAzureADAdministrator	Se actualizó correctamente un administrador de Azure Active Directory.
201 Created	ServerAzureADAdministrator	Ha creado correctamente un administrador de Azure Active Directory.
202 Accepted		Aceptado
Other Status Codes		Respuestas de error: *** 400 InvalidServerAdministratorTypePropertyName: el tipo de administrador de Active Directory del servidor debe ser ActiveDirectory 400 InvalidResourceRequestBody: las propiedades de recurso o recurso del cuerpo de la solicitud están vacías o no son válidas. 400 InvalidServerAzureADOnlyAuthenticationParameter: el usuario intentó establecer el parámetro AzureADOnlyAuthentication en false, que no está permitido, use azureADOnlyAuthentications API en su lugar. 400 InvalidServerAzureADAdminDeleteOperation: el usuario intentó eliminar el servidor Azure Active Azure admin cuando se establece AzureADOnlyAuthentication, use primero la API azureADOnlyAuthentications. 400 ServerAdministratorNameAlreadyExists: el usuario intentó establecer el administrador externo y el nombre principal ya existe en la base de datos "master". 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado. 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados. 404 OperationIdNotFound: la operación con id. no existe. 409 OperationCancelled: el usuario canceló la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió otra operación en el mismo recurso. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación. 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

Ejemplos

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

Respuesta de muestra

status code:: 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
  }
}

status code:: 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
  }
}

status code:: 202

Definiciones

Nombre	Description
AdministratorName	Nombre del administrador de Active Directory del servidor.
AdministratorType	Tipo del administrador del servidor.
ServerAzureADAdministrator	Administrador de Azure Active Directory.

AdministratorName

Enumeración

Nombre del administrador de Active Directory del servidor.

Valor	Description
ActiveDirectory

AdministratorType

Enumeración

Tipo del administrador del servidor.

Valor	Description
ActiveDirectory

ServerAzureADAdministrator

Object

Administrador de Azure Active Directory.

Nombre	Tipo	Description
id	string	Identificador de recurso.
name	string	Nombre del recurso.
properties.administratorType	AdministratorType	Tipo del administrador del servidor.
properties.azureADOnlyAuthentication	boolean	Autenticación solo de Azure Active Directory habilitada.
properties.login	string	Nombre de inicio de sesión del administrador del servidor.
properties.sid	string (uuid)	SID (id. de objeto) del administrador del servidor.
properties.tenantId	string (uuid)	Identificador de inquilino del administrador.
type	string	Tipo de recurso.

Compartir a través de