Servers - Update

Atualizações um servidor.

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

Parâmetros do URI

Name Em Necessário Tipo Description
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.

serverName
path True

string

O nome do servidor.

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 Tipo Description
identity

ResourceIdentity

Identidade do servidor

properties.administratorLogin

string

Nome de utilizador do administrador para o servidor. Uma vez criado, não pode ser alterado.

properties.administratorLoginPassword

string

A palavra-passe de início de sessão do administrador (necessária para a criação do servidor).

properties.administrators

ServerExternalAdministrator

O administrador do Azure Active Directory do servidor.

properties.federatedClientId

string

O ID de cliente utilizado para o cenário de CMK entre inquilinos

properties.keyId

string

Um URI de CMK da chave a utilizar para encriptação.

properties.minimalTlsVersion

string

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

properties.primaryUserAssignedIdentityId

string

O ID de recurso de uma identidade atribuída pelo utilizador a utilizar por predefinição.

properties.publicNetworkAccess

ServerNetworkAccessFlag

Se o acesso ao ponto final público é ou não permitido para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Se pretende ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

properties.version

string

A versão do servidor.

tags

object

Etiquetas de recursos.

Respostas

Name Tipo Description
200 OK

Server

O servidor foi atualizado com êxito.

202 Accepted

Aceite

Other Status Codes

Respostas de Erro: ***

  • 400 MissingIdentityId - Não é fornecida nenhuma identidade atribuída pelo utilizador quando o tipo de identidade está definido como UserAssigned

  • 400 InvalidPrimaryIdentityId - O utilizador 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, uma vez que não existe nenhum ponto final privado ativado para aceder ao servidor. Configure pontos finais 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 utilizador não tem acesso ao KeyId fornecido

  • 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId fornecido pelo utilizador não tem acesso ao KeyId fornecido

  • 400 ProvisioningDisabled – apresenta a mensagem de erro do autorizador da operação de recursos tal como está, sem alterações

  • 400 PrimaryIdentityMissingPermissionForKeyId - KeyId é fornecido pelo utilizador durante a criação, mas PrimaryUserAssignedIdentityId não é fornecido na chamada à API

  • 400 InvalidIdentityTypeForKeyId - KeyId é fornecido pelo utilizador durante a criação, mas o tipo de identidade não está definido como "UserAssigned"

  • 400 InvalidLoginName – o nome de início de sessão fornecido é inválido.

  • 400 InvalidUsername – o nome de utilizador fornecido contém carateres inválidos.

  • 400 Ipv6FeatureNotEnabled – o utilizador tentou ativar o suporte Ipv6 no servidor sem ativar o sinalizador de funcionalidade na subscrição ou o suporte de funcionalidades está atualmente desativado na região.

  • 400 PasswordTooShort – A palavra-passe fornecida é demasiado curta

  • 400 AadOnlyAuthenticationIsEnabled – A Autenticação Apenas do Azure Active Directory está ativada. Contacte o administrador do sistema.

  • 400 RegionDoesNotSupportVersion - Um utilizador tentou criar um servidor de uma versão especificada numa localização onde essa versão do servidor não é suportada.

  • 400 PasswordTooLong – a palavra-passe fornecida é demasiado longa.

  • 400 PasswordNotComplex - A palavra-passe fornecida não é suficientemente complexa.

  • 400 InvalidParameterValue – foi atribuído um valor inválido a um parâmetro.

  • 400 InvalidLocation – foi especificada uma localização inválida.

  • 400 InvalidServerName – nome de servidor inválido especificado.

  • 400 InvalidIdentifier - O identificador contém NULL ou um caráter unicode inválido.

  • 400 TokenTooLong – o token fornecido é demasiado longo.

  • 400 RegionDoesNotAllowProvisioning - A localização selecionada não está a aceitar novos servidores da Base de Dados do Windows SQL do Azure. Isto pode ser alterado posteriormente.

  • 400 ServerNotFound - O servidor pedido não foi encontrado.

  • 400 InvalidMinimalTlsVersion – versão TLS mínima inválida.

  • 400 InvalidExternalAdministratorLogin – nome de início de sessão de administrador externo inválido ou em falta.

  • 400 InvalidExternalAdministratorSid – ID de objeto de administrador externo inválido ou em falta.

  • 400 InvalidExternalAdministratorTenantId – ID de inquilino de administrador externo inválido ou em falta.

  • 400 ExternalAdministratorPrincipalType – tipo de principal de administrador externo inválido ou em falta. Selecione a partir de Utilizador, Aplicação ou Grupo.

  • 400 MissingExternalAdministratorWithAadOnlyAuth – para utilizar Azure AD Apenas Autenticação, forneça detalhes de um administrador externo.

  • 400 ExternalAdministratorLoginSameAsSqlAdmin – os nomes do administrador do Azure Active Directory e da conta de administrador do servidor têm de ser diferentes. Forneça valores diferentes.

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados.

  • 404 OperationIdNotFound - A operação com o ID não existe.

  • 404 SubscriptionNotFound - A subscrição pedida não foi encontrada.

  • 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 UpsertLogicalServerRequestAlreadyInProgress - Já está em curso um pedido de servidor lógico em curso. Tente o seu pedido novamente mais tarde.

  • 409 ServerDisabled - O servidor está desativado.

  • 409 ConflictingServerOperation - Está atualmente em curso uma operação para o servidor.

  • 409 SubscriptionDisabled - A subscrição está desativada.

  • 409 ServerQuotaExceeded – O servidor não pode ser adicionado a uma subscrição porque excederá a quota.

  • 409 ServerAlreadyExists - Nome do servidor duplicado.

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

  • 429 ConflictingSubscriptionOperation - Está em curso uma operação para a subscrição.

  • 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação.

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

Exemplos

Update a server

Pedido de amostra

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

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

Resposta da amostra

{
  "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",
    "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"
          }
        }
      }
    ]
  }
}

Definições

Name Description
AdministratorType

Tipo de administrador de gravidade.

IdentityType

O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.

PrincipalType

Tipo principal do administrador de gravidade.

PrivateEndpointConnectionProperties

Propriedades de uma ligação de ponto final privado.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Estado da ligação de ponto final privado.

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a ligação do serviço de ligação privada.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

O estado da ligação do serviço de ligação privada.

ResourceIdentity

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

Server

Um servidor de Base de Dados SQL do Azure.

ServerExternalAdministrator

Propriedades de um administrador do Active Directory.

ServerNetworkAccessFlag

Se o acesso ao ponto final público é ou não permitido para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

ServerPrivateEndpointConnection

Uma ligação de ponto final privado num servidor

ServerUpdate

Um pedido de atualização para um servidor de base de dados SQL do Azure.

ServerWorkspaceFeature

Se o servidor existente tem ou não uma área de trabalho criada e se permite a ligação da área de trabalho

UserIdentity

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

AdministratorType

Tipo de administrador de gravidade.

Name Tipo Description
ActiveDirectory

string

IdentityType

O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.

Name Tipo Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

PrincipalType

Tipo principal do administrador de gravidade.

Name Tipo Description
Application

string

Group

string

User

string

PrivateEndpointConnectionProperties

Propriedades de uma ligação de ponto final privado.

Name Tipo Description
groupIds

string[]

IDs de grupo.

privateEndpoint

PrivateEndpointProperty

Ponto final privado ao qual a ligação pertence.

privateLinkServiceConnectionState

PrivateLinkServiceConnectionStateProperty

Estado de ligação da ligação de ponto final privado.

provisioningState

PrivateEndpointProvisioningState

Estado da ligação de ponto final privado.

PrivateEndpointProperty

Name Tipo Description
id

string

ID de recurso do ponto final privado.

PrivateEndpointProvisioningState

Estado da ligação de ponto final privado.

Name Tipo Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a ligação do serviço de ligação privada.

Name Tipo Description
None

string

PrivateLinkServiceConnectionStateProperty

Name Tipo Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a ligação do serviço de ligação privada.

description

string

A descrição da ligação do serviço de ligação privada.

status

PrivateLinkServiceConnectionStateStatus

O estado da ligação do serviço de ligação privada.

PrivateLinkServiceConnectionStateStatus

O estado da ligação do serviço de ligação privada.

Name Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

ResourceIdentity

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

Name Tipo Description
principalId

string

O ID principal do Azure Active Directory.

tenantId

string

O ID de inquilino do Azure Active Directory.

type

IdentityType

O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.

userAssignedIdentities

<string,  UserIdentity>

Os IDs de recursos das identidades atribuídas pelo utilizador a utilizar

Server

Um servidor de Base de Dados SQL do Azure.

Name Tipo Description
id

string

ID do Recurso.

identity

ResourceIdentity

A identidade do Azure Active Directory do servidor.

kind

string

Tipo de servidor sql. Estes são os metadados utilizados para a experiência de portal do Azure.

location

string

Localização do recurso.

name

string

Nome do recurso.

properties.administratorLogin

string

Nome de utilizador do administrador para o servidor. Uma vez criado, não pode ser alterado.

properties.administratorLoginPassword

string

A palavra-passe de início de sessão do administrador (necessária para a criação do servidor).

properties.administrators

ServerExternalAdministrator

O administrador do Azure Active Directory do servidor.

properties.federatedClientId

string

O ID de cliente utilizado para o cenário de CMK entre inquilinos

properties.fullyQualifiedDomainName

string

O nome de domínio completamente qualificado do servidor.

properties.keyId

string

Um URI de CMK da chave a utilizar para encriptação.

properties.minimalTlsVersion

string

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

properties.primaryUserAssignedIdentityId

string

O ID de recurso de uma identidade atribuída pelo utilizador a utilizar por predefinição.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista de ligações de ponto final privado num servidor

properties.publicNetworkAccess

ServerNetworkAccessFlag

Se o acesso ao ponto final público é ou não permitido para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Se pretende ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

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 uma área de trabalho criada e se permite a ligação da área de trabalho

tags

object

Etiquetas de recursos.

type

string

Tipo de recurso.

ServerExternalAdministrator

Propriedades de um administrador do Active Directory.

Name Tipo Description
administratorType

AdministratorType

Tipo de administrador de gravidade.

azureADOnlyAuthentication

boolean

Apenas a Autenticação do Azure Active Directory está ativada.

login

string

Nome de início de sessão do administrador do servidor.

principalType

PrincipalType

Tipo principal do administrador de gravidade.

sid

string

SID (ID do objeto) do administrador do servidor.

tenantId

string

ID do inquilino do administrador.

ServerNetworkAccessFlag

Se o acesso ao ponto final público é ou não permitido para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

Name Tipo Description
Disabled

string

Enabled

string

ServerPrivateEndpointConnection

Uma ligação de ponto final privado num servidor

Name Tipo Description
id

string

ID do Recurso.

properties

PrivateEndpointConnectionProperties

Propriedades de ligação de ponto final privado

ServerUpdate

Um pedido de atualização para um servidor de base de dados SQL do Azure.

Name Tipo Description
identity

ResourceIdentity

Identidade do servidor

properties.administratorLogin

string

Nome de utilizador do administrador para o servidor. Uma vez criado, não pode ser alterado.

properties.administratorLoginPassword

string

A palavra-passe de início de sessão do administrador (necessária para a criação do servidor).

properties.administrators

ServerExternalAdministrator

O administrador do Azure Active Directory do servidor.

properties.federatedClientId

string

O ID de cliente utilizado para o cenário de CMK entre inquilinos

properties.fullyQualifiedDomainName

string

O nome de domínio completamente qualificado do servidor.

properties.keyId

string

Um URI de CMK da chave a utilizar para encriptação.

properties.minimalTlsVersion

string

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

properties.primaryUserAssignedIdentityId

string

O ID de recurso de uma identidade atribuída pelo utilizador a utilizar por predefinição.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista de ligações de ponto final privado num servidor

properties.publicNetworkAccess

ServerNetworkAccessFlag

Se o acesso ao ponto final público é ou não permitido para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Se pretende ou não restringir o acesso à rede de saída para este servidor. O valor é opcional, mas se for transmitido, tem de ser "Ativado" ou "Desativado"

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 uma área de trabalho criada e se permite a ligação da área de trabalho

tags

object

Etiquetas de recursos.

ServerWorkspaceFeature

Se o servidor existente tem ou não uma área de trabalho criada e se permite a ligação da área de trabalho

Name Tipo Description
Connected

string

Disconnected

string

UserIdentity

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

Name Tipo Description
clientId

string

O ID de cliente do Azure Active Directory.

principalId

string

O ID principal do Azure Active Directory.