Servers - Update

Referência

Serviço:: SQL Database

Versão da API:: 2023-08-01

Atualiza um servidor.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2023-08-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor na API do Azure Resource Manager ou no portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID da 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	Tipo	Description
identity	ResourceIdentity	Identidade do servidor
properties.administratorLogin	string	Nome de usuário do administrador para o servidor. Uma vez criado, ele não pode ser alterado.
properties.administratorLoginPassword	string	A senha de logon do administrador (necessária para a criação do servidor).
properties.administrators	ServerExternalAdministrator	O administrador do Azure Active Directory do servidor. Isso só pode ser usado no momento da criação do servidor. Se usado para atualização do servidor, ele será ignorado ou resultará em um erro. Para atualizações, as APIs individuais precisarão ser usadas.
properties.federatedClientId	string (uuid)	A ID do cliente usada para o cenário de CMK entre locatários
properties.isIPv6Enabled	ServerNetworkAccessFlag	Se deseja ou não habilitar o suporte IPv6 para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.keyId	string	Um URI do CMK da chave a ser usada para criptografia.
properties.minimalTlsVersion	MinimalTlsVersion	Versão mínima do TLS. Valores permitidos: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	A ID de recurso de uma identidade atribuída pelo usuário a ser usada por padrão.
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas se passado, deve ser "Habilitado" ou "Desabilitado" ou "SecuredByPerimeter"
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.version	string	A versão do servidor.
tags	object	Marcas de recurso.

Respostas

Nome	Tipo	Description
200 OK	Server	Atualizou com êxito o servidor.
202 Accepted		Aceitado Cabeçalhos Location: string
Other Status Codes	ErrorResponse	Respostas de erro: *** 400 ManagedInstanceStoppingOrStopped – Operação conflitante enviada enquanto a instância está no estado de parada/parada 400 ManagedInstanceStarting – Operação conflitante enviada enquanto a instância está no estado inicial 400 NameAlreadyExistsSoftDeleted – O nome do servidor solicitado é usado por um servidor em estado de exclusão reversível. Limpe ou recupere o servidor para desbloquear. 400 MissingIdentityId - Nenhuma identidade atribuída pelo usuário é fornecida quando o tipo de identidade é definido como UserAssigned 400 InvalidPrimaryIdentityId - O usuário fornece um valor para PrimaryUserIdentityId, mas o mesmo não está listado no parâmetro IdentityId 400 PECsNotExistingToDenyPublicNetworkAccess - Não é possível definir Negar Acesso à Rede Pública como Sim, pois não há nenhum ponto de extremidade privado habilitado para acessar o servidor. Configure pontos de extremidade privados e repita a operação (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists - O nome fornecido já existe. 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido 400 MissingPrimaryIdentity – PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido 400 ProvisioningDisabled – Exibe mensagem de erro do autorizador de operação de recursos como está, sem alterações 400 PrimaryIdentityMissingPermissionForKeyId - KeyId é fornecido pelo usuário durante a criação, mas PrimaryUserAssignedIdentityId não é fornecido na chamada à API 400 InvalidIdentityTypeForKeyId - KeyId é fornecido pelo usuário durante a criação, mas o tipo de identidade não é definido como 'UserAssigned' 400 InvalidLoginName – O nome de logon fornecido é inválido. 400 InvalidUsername – O nome de usuário fornecido contém caracteres inválidos. 400 Ipv6FeatureNotEnabled – o usuário tentou ativar o suporte ao Ipv6 no servidor sem habilitar o sinalizador de recursos na assinatura ou o suporte ao recurso está desabilitado na região no momento. 400 PasswordTooShort - A senha fornecida é muito curta 400 AadOnlyAuthenticationIsEnabled – Autenticação Somente do Azure Active Directory está habilitada. Entre em contato com o administrador do sistema. 400 RegionDoesNotSupportVersion – Um usuário tentou criar um servidor de uma versão especificada em um local onde não há suporte para essa versão do servidor. 400 PasswordTooLong – A senha fornecida é muito longa. 400 PasswordNotComplex - A senha fornecida não é complexa o suficiente. 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro. 400 InvalidLocation – Um local inválido foi especificado. 400 InvalidServerName – Nome do servidor inválido especificado. 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido. 400 TokenTooLong – O token fornecido é muito longo. 400 CMKOperationNotAllowed - O usuário tentou executar uma operação no servidor quando o servidor não tinha acesso ao Azure Key Vault. 400 ServerNotFound – O servidor solicitado não foi encontrado. 400 RegionDoesNotAllowProvisioning - O local selecionado não está aceitando novos servidores do Banco de Dados SQL do Windows Azure. Isso pode mudar posteriormente. 400 InvalidMinimalTlsVersion – versão mínima inválida do TLS. 400 InvalidExternalAdministratorLogin – Nome de logon de administrador externo inválido ou ausente. 400 InvalidExternalAdministratorSid – ID de objeto de administrador externo inválida ou ausente. 400 InvalidExternalAdministratorTenantId – ID de locatário de administrador externo inválida ou ausente. 400 ExternalAdministratorPrincipalType - Tipo de entidade de segurança de administrador externo inválido ou ausente. Selecione entre Usuário, Aplicativo ou Grupo. 400 MissingExternalAdministratorWithAadOnlyAuth – Para usar a Autenticação Somente do Azure AD, forneça detalhes de um administrador externo. 400 ExternalAdministratorLoginSameAsSqlAdmin - Os nomes do administrador do Azure Active Directory e da conta de administrador do servidor devem ser diferentes. Forneça valores diferentes. 400 ServerAdministratorNameAlreadyExists – o usuário tentou definir o administrador externo e o nome principal já existe no banco de dados 'mestre'. 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado 404 OperationIdNotFound – A operação com id não existe. 404 SubscriptionNotFound – A assinatura solicitada não foi encontrada. 409 CannotCancelOperation – A operação de gerenciamento está em um estado que não pode ser cancelado. 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 UpsertLogicalServerRequestAlreadyInProgress – uma solicitação de servidor lógico em andamento já está em andamento, tente sua solicitação novamente mais tarde. 409 ServerDisabled – O servidor está desabilitado. 409 ConflictingServerOperation – Uma operação está em andamento para o servidor. 409 SubscriptionDisabled – A assinatura está desabilitada. 409 ServerQuotaExceeded - O servidor não pode ser adicionado a uma assinatura porque excederá a cota. 409 ServerAlreadyExists – Nome do servidor duplicado. 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além do máximo de solicitações 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 do máximo de solicitações 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 ConflictingSubscriptionOperation – Uma operação está em andamento para a assinatura. 500 OperationTimedOut – A operação atingiu o tempo limite e foi revertida automaticamente. Tente novamente a operação. 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.

Nome

Tipo

Description

200 OK

Server

Atualizou com êxito o servidor.

202 Accepted

Aceitado

Cabeçalhos

Location: string

Other Status Codes

ErrorResponse

Respostas de erro: ***

400 ManagedInstanceStoppingOrStopped – Operação conflitante enviada enquanto a instância está no estado de parada/parada
400 ManagedInstanceStarting – Operação conflitante enviada enquanto a instância está no estado inicial
400 NameAlreadyExistsSoftDeleted – O nome do servidor solicitado é usado por um servidor em estado de exclusão reversível. Limpe ou recupere o servidor para desbloquear.
400 MissingIdentityId - Nenhuma identidade atribuída pelo usuário é fornecida quando o tipo de identidade é definido como UserAssigned
400 InvalidPrimaryIdentityId - O usuário fornece um valor para PrimaryUserIdentityId, mas o mesmo não está listado no parâmetro IdentityId
400 PECsNotExistingToDenyPublicNetworkAccess - Não é possível definir Negar Acesso à Rede Pública como Sim, pois não há nenhum ponto de extremidade privado habilitado para acessar o servidor. Configure pontos de extremidade privados e repita a operação (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database).
400 NameAlreadyExists - O nome fornecido já existe.
400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido
400 MissingPrimaryIdentity – PrimaryUserAssignedIdentityId fornecido pelo usuário não tem acesso ao KeyId fornecido
400 ProvisioningDisabled – Exibe mensagem de erro do autorizador de operação de recursos como está, sem alterações
400 PrimaryIdentityMissingPermissionForKeyId - KeyId é fornecido pelo usuário durante a criação, mas PrimaryUserAssignedIdentityId não é fornecido na chamada à API
400 InvalidIdentityTypeForKeyId - KeyId é fornecido pelo usuário durante a criação, mas o tipo de identidade não é definido como 'UserAssigned'
400 InvalidLoginName – O nome de logon fornecido é inválido.
400 InvalidUsername – O nome de usuário fornecido contém caracteres inválidos.
400 Ipv6FeatureNotEnabled – o usuário tentou ativar o suporte ao Ipv6 no servidor sem habilitar o sinalizador de recursos na assinatura ou o suporte ao recurso está desabilitado na região no momento.
400 PasswordTooShort - A senha fornecida é muito curta
400 AadOnlyAuthenticationIsEnabled – Autenticação Somente do Azure Active Directory está habilitada. Entre em contato com o administrador do sistema.
400 RegionDoesNotSupportVersion – Um usuário tentou criar um servidor de uma versão especificada em um local onde não há suporte para essa versão do servidor.
400 PasswordTooLong – A senha fornecida é muito longa.
400 PasswordNotComplex - A senha fornecida não é complexa o suficiente.
400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro.
400 InvalidLocation – Um local inválido foi especificado.
400 InvalidServerName – Nome do servidor inválido especificado.
400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido.
400 TokenTooLong – O token fornecido é muito longo.
400 CMKOperationNotAllowed - O usuário tentou executar uma operação no servidor quando o servidor não tinha acesso ao Azure Key Vault.
400 ServerNotFound – O servidor solicitado não foi encontrado.
400 RegionDoesNotAllowProvisioning - O local selecionado não está aceitando novos servidores do Banco de Dados SQL do Windows Azure. Isso pode mudar posteriormente.
400 InvalidMinimalTlsVersion – versão mínima inválida do TLS.
400 InvalidExternalAdministratorLogin – Nome de logon de administrador externo inválido ou ausente.
400 InvalidExternalAdministratorSid – ID de objeto de administrador externo inválida ou ausente.
400 InvalidExternalAdministratorTenantId – ID de locatário de administrador externo inválida ou ausente.
400 ExternalAdministratorPrincipalType - Tipo de entidade de segurança de administrador externo inválido ou ausente. Selecione entre Usuário, Aplicativo ou Grupo.
400 MissingExternalAdministratorWithAadOnlyAuth – Para usar a Autenticação Somente do Azure AD, forneça detalhes de um administrador externo.
400 ExternalAdministratorLoginSameAsSqlAdmin - Os nomes do administrador do Azure Active Directory e da conta de administrador do servidor devem ser diferentes. Forneça valores diferentes.
400 ServerAdministratorNameAlreadyExists – o usuário tentou definir o administrador externo e o nome principal já existe no banco de dados 'mestre'.
404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados.
404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado
404 OperationIdNotFound – A operação com id não existe.
404 SubscriptionNotFound – A assinatura solicitada não foi encontrada.
409 CannotCancelOperation – A operação de gerenciamento está em um estado que não pode ser cancelado.
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 UpsertLogicalServerRequestAlreadyInProgress – uma solicitação de servidor lógico em andamento já está em andamento, tente sua solicitação novamente mais tarde.
409 ServerDisabled – O servidor está desabilitado.
409 ConflictingServerOperation – Uma operação está em andamento para o servidor.
409 SubscriptionDisabled – A assinatura está desabilitada.
409 ServerQuotaExceeded - O servidor não pode ser adicionado a uma assinatura porque excederá a cota.
409 ServerAlreadyExists – Nome do servidor duplicado.
429 SubscriptionTooManyCreateUpdateRequests – Solicitações além do máximo de solicitações 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 do máximo de solicitações 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 ConflictingSubscriptionOperation – Uma operação está em andamento para a assinatura.
500 OperationTimedOut – A operação atingiu o tempo limite e foi revertida automaticamente. Tente novamente a operação.
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.

Exemplos

Update a server

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2023-08-01

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "placeholder",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "isIPv6Enabled": "Enabled"
  }
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ServerUpdate.json
// this example is just showing the usage of "Servers_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlServerResource created on azure
// for more information of creating SqlServerResource, please refer to the document of SqlServerResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-7398";
string serverName = "sqlcrudtest-4645";
ResourceIdentifier sqlServerResourceId = SqlServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
SqlServerResource sqlServer = client.GetSqlServerResource(sqlServerResourceId);

// invoke the operation
SqlServerPatch patch = new SqlServerPatch
{
    AdministratorLogin = "dummylogin",
    AdministratorLoginPassword = "placeholder",
    PublicNetworkAccess = ServerNetworkAccessFlag.Disabled,
    RestrictOutboundNetworkAccess = ServerNetworkAccessFlag.Enabled,
    IsIPv6Enabled = ServerNetworkAccessFlag.Enabled,
};
ArmOperation<SqlServerResource> lro = await sqlServer.UpdateAsync(WaitUntil.Completed, patch);
SqlServerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlServerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "location": "japaneast",
  "kind": "v12.0",
  "properties": {
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "administratorLogin": "dummylogin",
    "version": "12.0",
    "state": "Ready",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "isIPv6Enabled": "Enabled",
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
        "properties": {
          "provisioningState": "Ready",
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "Auto-approved",
            "actionsRequired": "None"
          }
        }
      }
    ]
  }
}

Código de status:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/serverOperationResults/00000000-0000-0000-0000-000000000000?api-version=2023-05-01

Definições

Nome	Description
AdministratorType	Tipo do administrador de sever.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExternalGovernanceStatus	Status da governança externa.
IdentityType	O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.
MinimalTlsVersion	Versão mínima do TLS. Valores permitidos: 'None', 1.0', '1.1', '1.2', '1.3'
PrincipalType	Tipo de entidade de segurança do administrador de sever.
PrivateEndpointConnectionProperties	Propriedades de uma conexão de ponto de extremidade privado.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Estado da conexão de ponto de extremidade privado.
PrivateLinkServiceConnectionStateActionsRequire	As ações necessárias para a conexão do serviço de link privado.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	O status da conexão do serviço de link privado.
ResourceIdentity	Configuração de identidade do Azure Active Directory para um recurso.
Server	Um servidor do Banco de Dados SQL do Azure.
ServerExternalAdministrator	Propriedades de um administrador do active directory.
ServerNetworkAccessFlag	Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
ServerPrivateEndpointConnection	Uma conexão de ponto de extremidade privado em um servidor
ServerPublicNetworkAccessFlag	Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas se passado, deve ser "Habilitado" ou "Desabilitado" ou "SecuredByPerimeter"
ServerUpdate	Uma solicitação de atualização para um servidor do Banco de Dados SQL do Azure.
ServerWorkspaceFeature	Se o servidor existente tem ou não um workspace criado e se ele permite a conexão do workspace
UserIdentity	Configuração de identidade do Azure Active Directory para um recurso.

AdministratorType

Enumeração

Tipo do administrador de sever.

Valor	Description
ActiveDirectory

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ExternalGovernanceStatus

Enumeração

Status da governança externa.

Valor	Description
Disabled
Enabled

IdentityType

Enumeração

O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.

Valor	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

MinimalTlsVersion

Enumeração

Versão mínima do TLS. Valores permitidos: 'None', 1.0', '1.1', '1.2', '1.3'

Valor	Description
1.0
1.1
1.2
1.3
None

PrincipalType

Enumeração

Tipo de entidade de segurança do administrador de sever.

Valor	Description
Application
Group
User

PrivateEndpointConnectionProperties

Objeto

Propriedades de uma conexão de ponto de extremidade privado.

Nome	Tipo	Description
groupIds	string[]	IDs de grupo.
privateEndpoint	PrivateEndpointProperty	Ponto de extremidade privado ao qual a conexão pertence.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Estado de conexão da conexão de ponto de extremidade privado.
provisioningState	PrivateEndpointProvisioningState	Estado da conexão de ponto de extremidade privado.

PrivateEndpointProperty

Objeto

Nome	Tipo	Description
id	string	ID do recurso do ponto de extremidade privado.

PrivateEndpointProvisioningState

Enumeração

Estado da conexão de ponto de extremidade privado.

Valor	Description
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Enumeração

As ações necessárias para a conexão do serviço de link privado.

Valor	Description
None

PrivateLinkServiceConnectionStateProperty

Objeto

Nome	Tipo	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	As ações necessárias para a conexão do serviço de link privado.
description	string	A descrição da conexão do serviço de link privado.
status	PrivateLinkServiceConnectionStateStatus	O status da conexão do serviço de link privado.

PrivateLinkServiceConnectionStateStatus

Enumeração

O status da conexão do serviço de link privado.

Valor	Description
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Objeto

Configuração de identidade do Azure Active Directory para um recurso.

Nome	Tipo	Description
principalId	string (uuid)	A ID da entidade de segurança do Azure Active Directory.
tenantId	string (uuid)	A ID do locatário do Azure Active Directory.
type	IdentityType	O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.
userAssignedIdentities	<string, UserIdentity>	As IDs de recurso das identidades atribuídas pelo usuário a serem usadas

Server

Objeto

Um servidor do Banco de Dados SQL do Azure.

Nome	Tipo	Description
id	string	ID do recurso.
identity	ResourceIdentity	A identidade do Azure Active Directory do servidor.
kind	string	Tipo de sql server. Esses são metadados usados para a experiência do portal do Azure.
location	string	Local do recurso.
name	string	Nome do recurso.
properties.administratorLogin	string	Nome de usuário do administrador para o servidor. Uma vez criado, ele não pode ser alterado.
properties.administratorLoginPassword	string	A senha de logon do administrador (necessária para a criação do servidor).
properties.administrators	ServerExternalAdministrator	O administrador do Azure Active Directory do servidor. Isso só pode ser usado no momento da criação do servidor. Se usado para atualização do servidor, ele será ignorado ou resultará em um erro. Para atualizações, as APIs individuais precisarão ser usadas.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Status da governança externa.
properties.federatedClientId	string (uuid)	A ID do cliente usada para o cenário de CMK entre locatários
properties.fullyQualifiedDomainName	string	O nome de domínio totalmente qualificado do servidor.
properties.isIPv6Enabled	ServerNetworkAccessFlag	Se deseja ou não habilitar o suporte IPv6 para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.keyId	string	Um URI do CMK da chave a ser usada para criptografia.
properties.minimalTlsVersion	MinimalTlsVersion	Versão mínima do TLS. Valores permitidos: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	A ID de recurso de uma identidade atribuída pelo usuário a ser usada por padrão.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lista de conexões de ponto de extremidade privado em um servidor
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas se passado, deve ser "Habilitado" ou "Desabilitado" ou "SecuredByPerimeter"
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.state	string	O estado do servidor.
properties.version	string	A versão do servidor.
properties.workspaceFeature	ServerWorkspaceFeature	Se o servidor existente tem ou não um workspace criado e se ele permite a conexão do workspace
tags	object	Marcas de recurso.
type	string	Tipo de recurso.

ServerExternalAdministrator

Objeto

Propriedades de um administrador do active directory.

Nome	Tipo	Description
administratorType	AdministratorType	Tipo do administrador de sever.
azureADOnlyAuthentication	boolean	Somente autenticação do Azure Active Directory habilitada.
login	string	Nome de logon do administrador do servidor.
principalType	PrincipalType	Tipo de entidade de segurança do administrador de sever.
sid	string (uuid)	SID (ID do objeto) do administrador do servidor.
tenantId	string (uuid)	ID do locatário do administrador.

ServerNetworkAccessFlag

Enumeração

Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'

Valor	Description
Disabled
Enabled

ServerPrivateEndpointConnection

Objeto

Uma conexão de ponto de extremidade privado em um servidor

Nome	Tipo	Description
id	string	ID do recurso.
properties	PrivateEndpointConnectionProperties	Propriedades de conexão de ponto de extremidade privado

ServerPublicNetworkAccessFlag

Enumeração

Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas se passado, deve ser "Habilitado" ou "Desabilitado" ou "SecuredByPerimeter"

Valor	Description
Disabled
Enabled
SecuredByPerimeter

ServerUpdate

Objeto

Uma solicitação de atualização para um servidor do Banco de Dados SQL do Azure.

Nome	Tipo	Description
identity	ResourceIdentity	Identidade do servidor
properties.administratorLogin	string	Nome de usuário do administrador para o servidor. Uma vez criado, ele não pode ser alterado.
properties.administratorLoginPassword	string	A senha de logon do administrador (necessária para a criação do servidor).
properties.administrators	ServerExternalAdministrator	O administrador do Azure Active Directory do servidor. Isso só pode ser usado no momento da criação do servidor. Se usado para atualização do servidor, ele será ignorado ou resultará em um erro. Para atualizações, as APIs individuais precisarão ser usadas.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Status da governança externa.
properties.federatedClientId	string (uuid)	A ID do cliente usada para o cenário de CMK entre locatários
properties.fullyQualifiedDomainName	string	O nome de domínio totalmente qualificado do servidor.
properties.isIPv6Enabled	ServerNetworkAccessFlag	Se deseja ou não habilitar o suporte IPv6 para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.keyId	string	Um URI do CMK da chave a ser usada para criptografia.
properties.minimalTlsVersion	MinimalTlsVersion	Versão mínima do TLS. Valores permitidos: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	A ID de recurso de uma identidade atribuída pelo usuário a ser usada por padrão.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lista de conexões de ponto de extremidade privado em um servidor
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Se o acesso ao ponto de extremidade público é permitido ou não para este servidor. O valor é opcional, mas se passado, deve ser "Habilitado" ou "Desabilitado" ou "SecuredByPerimeter"
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Se deseja ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.state	string	O estado do servidor.
properties.version	string	A versão do servidor.
properties.workspaceFeature	ServerWorkspaceFeature	Se o servidor existente tem ou não um workspace criado e se ele permite a conexão do workspace
tags	object	Marcas de recurso.

ServerWorkspaceFeature

Enumeração

Se o servidor existente tem ou não um workspace criado e se ele permite a conexão do workspace

Valor	Description
Connected
Disconnected

UserIdentity

Objeto

Configuração de identidade do Azure Active Directory para um recurso.

Nome	Tipo	Description
clientId	string (uuid)	A ID do cliente do Azure Active Directory.
principalId	string (uuid)	A ID da entidade de segurança do Azure Active Directory.

Compartilhar via

Servers - Update

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

Update a server

Solicitação de exemplo

Resposta de exemplo

Definições

AdministratorType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

IdentityType

MinimalTlsVersion

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerPublicNetworkAccessFlag

ServerUpdate

ServerWorkspaceFeature

UserIdentity