Servers - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Cria ou atualiza um servidor.

PUT 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	Necessário	Tipo	Description
location	True	string	Localização do recurso.
identity		ResourceIdentity	A identidade do Azure Active Directory 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.
201 Created	Server	O servidor foi criado 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

Create server

Sample Request

HTTP

PUT 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",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled"
  },
  "location": "Japan East"
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ServerInner;
import com.azure.resourcemanager.sql.models.PrincipalType;
import com.azure.resourcemanager.sql.models.ServerExternalAdministrator;
import com.azure.resourcemanager.sql.models.ServerNetworkAccessFlag;
import java.util.UUID;

/** Samples for Servers CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerCreate.json
     */
    /**
     * Sample code: Create server.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().createOrUpdate("sqlcrudtest-7398", "sqlcrudtest-4645",
            new ServerInner().withLocation("Japan East").withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withPublicNetworkAccess(ServerNetworkAccessFlag.ENABLED)
                .withAdministrators(new ServerExternalAdministrator().withPrincipalType(PrincipalType.USER)
                    .withLogin("bob@contoso.com").withSid(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withTenantId(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withAzureADOnlyAuthentication(true))
                .withRestrictOutboundNetworkAccess(ServerNetworkAccessFlag.ENABLED),
            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

Sample Response

Status code:

200

{
  "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": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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"
          }
        }
      }
    ]
  }
}

Status code:

201

{
  "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",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "version": "12.0",
    "state": "Ready",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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"
          }
        }
      }
    ]
  }
}

Status code:

202

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

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.