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 gerenciada.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
administratorName	path	True	AdministratorName
managedInstanceName	path	True	string	O nome da instância gerenciada.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
properties.administratorType	True	ManagedInstanceAdministratorType	Tipo do administrador da instância gerenciada.
properties.login	True	string	Nome de logon do administrador da instância gerenciada.
properties.sid	True	string	SID (ID do objeto) do administrador da instância gerenciada.
properties.tenantId		string	ID do locatário do administrador da instância gerenciada.

Respostas

Nome	Tipo	Description
200 OK	ManagedInstanceAdministrator	Atualizou com êxito o administrador da instância gerenciada.
201 Created	ManagedInstanceAdministrator	O administrador da instância gerenciada foi criado com êxito.
202 Accepted		Aceito
Other Status Codes		Respostas de erro: *** 400 InvalidManagedServerAdministratorType – tipo de administrador inválido especificado nas propriedades. 400 InvalidResourceRequestBody - O recurso ou as propriedades do recurso no corpo da solicitação são vazios ou inválidos. 400 InvalidManagedServerAzureADAdminDeleteOperation – o usuário tentou excluir o administrador do Azure Active Azure do servidor gerenciado quando a AzureADOnlyAuthentication estiver definida, use a API azureADOnlyAuthentications primeiro. 400 InvalidManagedServerAADOnlyAuthTypePropertyName – O tipo de autenticação somente do Azure Active Directory do Servidor Gerenciado deve ser Padrão 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro. 400 InvalidLoginName - O nome de logon fornecido é inválido. 400 PrincipalNotFoundInTenant – A pesquisa do AzureAD não retornou nenhum resultado para esse nome. 400 ServerPrincipalHasDuplicateDisplayNameInAad – A pesquisa do AzureAD retornou vários resultados para esse nome. 400 ManagedInstanceIsBusy – Instância Gerenciada está ocupado com outra solicitação. 400 InvalidPrincipalType - Não há suporte para esse tipo de entidade de segurança no Banco de Dados do Windows SQL do Azure. 400 ServerPrincipalCreateLoginBadSyntax - Houve um erro de sintaxe ao executar a instrução Criar Logon para Azure AD Administrador. 400 ServicePrincipalLookupInAadFailed – Falha na Pesquisa do AzureAD devido a erros de infraestrutura de serviço. 400 TenantNotFoundInActiveDirectory – O locatário não está disponível no Active Directory. 400 InvalidUsername - O nome de usuário fornecido contém caracteres inválidos. 400 ManagedInstanceHasNoPermissionsToAccessAad – Tentativa de executar a operação, que envolve um logon ou logon não existente no qual a entidade de segurança em execução não tem permissões. 403 ServicePrincipalLookupInAadFailedIdentityForbidden – Falha na Pesquisa do AzureAD porque a MSI não recebeu permissões de leitura no AAD. 404 ServerNotInSubscription – O servidor especificado não existe na assinatura especificada. 404 ManagedInstanceNotInSubscriptionResourceGroup – A instância gerenciada especificada não existe no grupo de recursos e na assinatura especificados. 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada. 404 OperationIdNotFound – A operação com id não existe. 404 ResourceNotFound – O recurso solicitado não foi encontrado. 409 OperationCancelled – A operação foi cancelada pelo usuário. 409 OperationInterrupted – A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 409 ServerPrincipalAlreadyExists – Tente criar a entidade de segurança do servidor com um nome não exclusivo. 409 ServerPrincipalCurrentlyLoggedIn – Autoexplicativo. 409 ServerPrincipalOwnsJobs – Tente remover um logon quando ele tiver trabalhos ativos. 409 ServerPrincipalIsGrantorOfPermissions – tentativa de remover uma entidade de segurança do servidor, que é um concessor de permissões. 409 ServerPrincipalOwnsDatabase – altere o proprietário dos bancos de dados antes de descartar o logon. 409 ServerPrincipalUsedInTriggerOrEventNotification – Tentativa de remover o logon, que é usado como um contexto de execução de um gatilho ou notificação de evento. 409 ServerPrincipalOwnsObjects – Tente remover um logon, que possui objetos. 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente. 500 ActiveDirectoryLookupTimedOut – A operação não pôde ser concluída no momento. Tente novamente mais tarde. 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 504 RequestTimeout – A solicitação 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 de exemplo

Código de status:: 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 status:: 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 status:: 202

Update administrator of managed instance

Solicitação de exemplo

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 de exemplo

Código de status:: 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 status:: 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 status:: 202

Definições

Nome	Description
AdministratorName
ManagedInstanceAdministrator	Um administrador de instância gerenciada SQL do Azure.
ManagedInstanceAdministratorType	Tipo do administrador da instância gerenciada.

AdministratorName

Nome	Tipo	Description
ActiveDirectory	string

ManagedInstanceAdministrator

Um administrador de instância gerenciada SQL do Azure.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.administratorType	ManagedInstanceAdministratorType	Tipo do administrador da instância gerenciada.
properties.login	string	Nome de logon do administrador da instância gerenciada.
properties.sid	string	SID (ID do objeto) do administrador da instância gerenciada.
properties.tenantId	string	ID do locatário do administrador da instância gerenciada.
type	string	Tipo de recurso.

ManagedInstanceAdministratorType

Tipo do administrador da instância gerenciada.

Nome	Tipo	Description
ActiveDirectory	string

Compartilhar via

Managed Instance Administrators - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

Create administrator of managed instance

Solicitação de exemplo

Resposta de exemplo

Update administrator of managed instance

Solicitação de exemplo

Resposta de exemplo

Definições

AdministratorName

ManagedInstanceAdministrator

ManagedInstanceAdministratorType

Recursos adicionais