Managed Instance Administrators - Create Or Update

Referencia

Servicio:: SQL Database

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

Crea o actualiza un administrador de instancia administrada.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	Nombre de la instancia administrada.
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.
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	ManagedInstanceAdministratorType	Tipo de administrador de instancia administrada.
properties.login	True	string	Nombre de inicio de sesión del administrador de la instancia administrada.
properties.sid	True	string (uuid)	SID (id. de objeto) del administrador de instancia administrada.
properties.tenantId		string (uuid)	Identificador de inquilino del administrador de la instancia administrada.

Respuestas

Nombre	Tipo	Description
200 OK	ManagedInstanceAdministrator	Se actualizó correctamente el administrador de la instancia administrada.
201 Created	ManagedInstanceAdministrator	Ha creado correctamente el administrador de la instancia administrada.
202 Accepted		Aceptado
Other Status Codes		Respuestas de error: *** 400 InvalidManagedServerAdministratorType: tipo de administrador no válido especificado en las propiedades. 400 InvalidResourceRequestBody: las propiedades de recurso o recurso del cuerpo de la solicitud están vacías o no son válidas. 400 InvalidManagedServerAzureADAdminDeleteOperation: el usuario intentó eliminar el servidor administrado Azure Active Azure admin cuando se establece AzureADOnlyAuthentication, use primero la API azureADOnlyAuthentications. 400 InvalidManagedServerAADOnlyAuthTypePropertyName: el tipo de autenticación de Azure Active Directory solo del servidor administrado debe ser Predeterminado 400 InvalidParameterValue: se ha proporcionado un valor no válido a un parámetro. 400 InvalidLoginName: el nombre de inicio de sesión proporcionado no es válido. 400 PrincipalNotFoundInTenant: La búsqueda de AzureAD no devolvió ningún resultado para este nombre. 400 ServerPrincipalHasDuplicateDisplayNameInAad: La búsqueda de AzureAD devolvió varios resultados para este nombre. 400 ManagedInstanceIsBusy: instancia administrada está ocupada con otra solicitud. 400 InvalidPrincipalType: este tipo de entidad de seguridad no se admite en Windows Azure SQL Database. 400 ServerPrincipalCreateLoginBadSyntax: se produjo un error de sintaxis al ejecutar la instrucción Create Login para el administrador de Azure AD. 400 ServicePrincipalLookupInAadFailed: error en la búsqueda de AzureAD debido a errores de infraestructura de servicio. 400 TenantNotFoundInActiveDirectory: el inquilino no está disponible en Active Directory. 400 InvalidUsername: el nombre de usuario proporcionado contiene caracteres no válidos. 400 ManagedInstanceHasNoPermissionsToAccessAad: intento de realizar la operación, lo que implica un inicio de sesión o inicio de sesión no existente en el que la entidad de seguridad en ejecución no tiene permisos. 403 ServicePrincipalLookupInAadFailedIdentityForbidden: error en la búsqueda de AzureAD porque a MSI no se le concedieron permisos de lectura en AAD. 404 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada. 404 ManagedInstanceNotInSubscriptionResourceGroup: la instancia administrada especificada no existe en el grupo de recursos y la suscripción especificados. 404 SubscriptionNotFound: no se encontró la suscripción solicitada. 404 OperationIdNotFound: la operación con id. no existe. 404 ResourceNotFound: no se encontró el recurso solicitado. 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. 409 ServerPrincipalAlreadyExists: intente crear una entidad de seguridad de servidor con un nombre no único. 409 ServerPrincipalCurrentlyLoggedIn: explicativo por sí mismo. 409 ServerPrincipalOwnsJobs: intente quitar un inicio de sesión cuando tenga trabajos activos. 409 ServerPrincipalIsGrantorOfPermissions: intenta quitar una entidad de seguridad de servidor, que es un receptor de permisos. 409 ServerPrincipalOwnsDatabase: cambie el propietario de las bases de datos antes de quitar el inicio de sesión. 409 ServerPrincipalUsedInTriggerOrEventNotification: intento de quitar el inicio de sesión, que se usa como contexto de ejecución de un desencadenador o notificación de eventos. 409 ServerPrincipalOwnsObjects: intenta quitar un inicio de sesión, que posee objetos. 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. 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. 500 ActiveDirectoryLookupTimedOut: la operación no se pudo completar en este momento. Inténtelo de nuevo más tarde. 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles. 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles. 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

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

Respuesta de muestra

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

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

status code:: 202

Update administrator of managed instance

Solicitud de ejemplo

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

Respuesta de muestra

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

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

status code:: 202

Definiciones

Nombre	Description
AdministratorName
ManagedInstanceAdministrator	Un administrador de instancia administrada de Azure SQL.
ManagedInstanceAdministratorType	Tipo de administrador de instancia administrada.

AdministratorName

Enumeración

Valor	Description
ActiveDirectory

ManagedInstanceAdministrator

Object

Un administrador de instancia administrada de Azure SQL.

Nombre	Tipo	Description
id	string	Identificador de recurso.
name	string	Nombre del recurso.
properties.administratorType	ManagedInstanceAdministratorType	Tipo de administrador de instancia administrada.
properties.login	string	Nombre de inicio de sesión del administrador de la instancia administrada.
properties.sid	string (uuid)	SID (id. de objeto) del administrador de instancia administrada.
properties.tenantId	string (uuid)	Identificador de inquilino del administrador de la instancia administrada.
type	string	Tipo de recurso.

ManagedInstanceAdministratorType

Enumeración

Tipo de administrador de instancia administrada.

Valor	Description
ActiveDirectory

Compartir a través de

Managed Instance Administrators - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

Create administrator of managed instance

Solicitud de ejemplo

Respuesta de muestra

Update administrator of managed instance

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AdministratorName

ManagedInstanceAdministrator

ManagedInstanceAdministratorType

Recursos adicionales