Managed Instance Administrators - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Cria ou atualiza um administrador de instância gerida.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	O nome da instância gerida.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Necessário	Tipo	Description
properties.administratorType	True	ManagedInstanceAdministratorType	Tipo de administrador de instância gerida.
properties.login	True	string	Nome de início de sessão do administrador da instância gerida.
properties.sid	True	string	SID (ID do objeto) do administrador da instância gerida.
properties.tenantId		string	ID do inquilino do administrador da instância gerida.

Respostas

Name	Tipo	Description
200 OK	ManagedInstanceAdministrator	O administrador da instância gerida foi atualizado com êxito.
201 Created	ManagedInstanceAdministrator	Criou com êxito o administrador da instância gerida.
202 Accepted		Aceite
Other Status Codes		Respostas de Erro: *** 400 InvalidManagedServerAdministratorType - Tipo de administrador inválido especificado nas propriedades. 400 InvalidResourceRequestBody – as propriedades do recurso ou recurso no corpo do pedido estão vazias ou são inválidas. 400 InvalidManagedServerAzureADAdminDeleteOperation – o utilizador tentou eliminar o administrador do Azure Active Azure do servidor gerido quando o AzureADOnlyAuthentication está definido, utilize primeiro a API azureADOnlyAuthentications. 400 InvalidManagedServerAADOnlyAuthTypePropertyName - O tipo de autenticação apenas do Azure Active Directory do Servidor Gerido deve ser Predefinido 400 InvalidParameterValue – foi atribuído um valor inválido a um parâmetro. 400 InvalidLoginName – o nome de início de sessão fornecido é inválido. 400 PrincipalNotFoundInTenant - A pesquisa do AzureAD não devolveu resultados para este nome. 400 ServerPrincipalHasDuplicateDisplayNameInAad – Pesquisa do AzureAD devolveu vários resultados para este nome. 400 ManagedInstanceIsBusy – A Instância Gerida está ocupada com outro pedido. 400 InvalidPrincipalType – este tipo principal não é suportado na Base de Dados do Windows SQL do Azure. 400 ServerPrincipalCreateLoginBadSyntax – Ocorreu um Erro de Sintaxe ao executar a instrução Criar Início de Sessão para Azure AD Administrador. 400 ServicePrincipalLookupInAadFailed – a Pesquisa do AzureAD falhou devido a erros de infraestrutura de serviço. 400 TenantNotFoundInActiveDirectory - O inquilino não está disponível no active directory. 400 InvalidUsername – o nome de utilizador fornecido contém carateres inválidos. 400 ManagedInstanceHasNoPermissionsToAccessAad – tentativa de executar a operação, que envolve um início de sessão ou início de sessão não existente no qual a execução do principal não tem permissões. 403 ServicePrincipalLookupInAadFailedIdentityForbidden – a Pesquisa do AzureAD falhou porque não foi concedida permissão de leitura ao MSI no AAD. 404 ServerNotInSubscription - O servidor especificado não existe na subscrição especificada. 404 ManagedInstanceNotInSubscriptionResourceGroup - A instância gerida especificada não existe no grupo de recursos e subscrição especificados. 404 SubscriptionNotFound - A subscrição pedida não foi encontrada. 404 OperationIdNotFound - A operação com o ID não existe. 404 ResourceNotFound – o recurso pedido não foi encontrado. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 409 ServerPrincipalAlreadyExists – tentativa de criar o principal de servidor com um nome não exclusivo. 409 ServerPrincipalCurrentlyLoggedIn - Auto-explicativo. 409 ServerPrincipalOwnsJobs – tente remover um início de sessão quando tiver tarefas ativas. 409 ServerPrincipalIsGrantorOfPermissions – tentativa de remover um principal de servidor, que é um concededor de permissões. 409 ServerPrincipalOwnsDatabase – altere o proprietário das bases de dados antes de remover o início de sessão. 409 ServerPrincipalUsedInTriggerOrEventNotification – tentativa de remover o início de sessão, que é utilizado como um contexto de execução de um acionador ou notificação de evento. 409 ServerPrincipalOwnsObjects – tentativa de remover um início de sessão, que detém objetos. 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 500 ActiveDirectoryLookupTimedOut – não foi possível concluir a operação neste momento. Tente novamente mais tarde. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 504 RequestTimeout - O pedido de serviço excedeu o tempo limite permitido.

Exemplos

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

Resposta da amostra

Código de estado:: 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"
}

Código de estado:: 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"
}

Código de estado:: 202

Update administrator of managed instance

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
}

Código de estado:: 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"
}

Código de estado:: 202

Definições

Name	Description
AdministratorName
ManagedInstanceAdministrator	Um administrador de instância gerida SQL do Azure.
ManagedInstanceAdministratorType	Tipo de administrador de instância gerida.

AdministratorName

Name	Tipo	Description
ActiveDirectory	string

ManagedInstanceAdministrator

Um administrador de instância gerida SQL do Azure.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.administratorType	ManagedInstanceAdministratorType	Tipo de administrador de instância gerida.
properties.login	string	Nome de início de sessão do administrador da instância gerida.
properties.sid	string	SID (ID do objeto) do administrador da instância gerida.
properties.tenantId	string	ID do inquilino do administrador da instância gerida.
type	string	Tipo de recurso.

ManagedInstanceAdministratorType

Tipo de administrador de instância gerida.

Name	Tipo	Description
ActiveDirectory	string

Partilhar via

Managed Instance Administrators - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

Create administrator of managed instance

Pedido de amostra

Resposta da amostra

Update administrator of managed instance

Pedido de amostra

Resposta da amostra

Definições

AdministratorName

ManagedInstanceAdministrator

ManagedInstanceAdministratorType

Recursos adicionais