Servers - Create Or Update

Referencia

Servicio:: SQL Database

Versión de la API:: 2021-11-01

Crea o actualiza un servidor.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
serverName	path	True	string	El nombre del servidor.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación del recurso
identity		ResourceIdentity	Identidad de Azure Active Directory del servidor.
properties.administratorLogin		string	Nombre de usuario del administrador para el servidor. Una vez creado, no se puede cambiar.
properties.administratorLoginPassword		string	Contraseña de inicio de sesión del administrador (necesaria para la creación del servidor).
properties.administrators		ServerExternalAdministrator	Administrador de Azure Active Directory del servidor.
properties.federatedClientId		string	El identificador de cliente que se usa para el escenario de CMK entre inquilinos
properties.keyId		string	URI de CMK de la clave que se va a usar para el cifrado.
properties.minimalTlsVersion		string	Versión mínima de TLS. Valores permitidos: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId		string	Identificador de recurso de una identidad asignada por el usuario que se va a usar de forma predeterminada.
properties.publicNetworkAccess		ServerNetworkAccessFlag	Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".
properties.restrictOutboundNetworkAccess		ServerNetworkAccessFlag	Si se va a restringir o no el acceso de red saliente para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".
properties.version		string	Versión del servidor.
tags		object	Etiquetas del recurso.

Respuestas

Nombre	Tipo	Description
200 OK	Server	Se actualizó correctamente el servidor.
201 Created	Server	Se creó correctamente el servidor.
202 Accepted		Aceptado
Other Status Codes		Respuestas de error: *** 400 MissingIdentityId: no se proporciona ninguna identidad asignada por el usuario cuando el tipo de identidad está establecido en UserAssigned 400 InvalidPrimaryIdentityId: el usuario proporciona un valor para PrimaryUserIdentityId, pero el mismo no aparece en el parámetro IdentityId. 400 PECsNotExistingToDenyPublicNetworkAccess: no se puede establecer Denegar el acceso a la red pública en Sí, ya que no hay ningún punto de conexión privado habilitado para acceder al servidor. Configure puntos de conexión privados y vuelva a intentar la operación (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists: el nombre proporcionado ya existe. 400 UmiMissingAkvPermissions: PrimaryUserAssignedIdentityId proporcionado por el usuario no tiene acceso a KeyId proporcionado 400 MissingPrimaryIdentity: PrimaryUserAssignedIdentityId proporcionado por el usuario no tiene acceso a KeyId proporcionado 400 ProvisioningDisabled: muestra el mensaje de error del autorizador de la operación de recursos tal cual, sin cambios 400 PrimaryIdentityMissingPermissionForKeyId: el usuario proporciona KeyId durante la creación, pero PrimaryUserAssignedIdentityId no se proporciona en la llamada API. 400 InvalidIdentityTypeForKeyId: el usuario proporciona KeyId durante la creación, pero el tipo de identidad no está establecido en "UserAssigned". 400 InvalidLoginName: el nombre de inicio de sesión proporcionado no es válido. 400 InvalidUsername: el nombre de usuario proporcionado contiene caracteres no válidos. 400 Ipv6FeatureNotEnabled: el usuario intentó activar la compatibilidad con Ipv6 en el servidor sin habilitar la marca de características en la suscripción o la compatibilidad con características está deshabilitada actualmente en la región. 400 PasswordTooShort: la contraseña proporcionada es demasiado corta 400 AadOnlyAuthenticationIsEnabled: la autenticación solo de Azure Active Directory está habilitada. Póngase en contacto con el administrador del sistema. 400 RegionDoesNotSupportVersion: un usuario intentó crear un servidor de una versión especificada en una ubicación donde no se admite esa versión del servidor. 400 PasswordTooLong: la contraseña proporcionada es demasiado larga. 400 PasswordNotComplex: la contraseña proporcionada no es lo suficientemente compleja. 400 InvalidParameterValue: se ha dado un valor no válido a un parámetro. 400 InvalidLocation: se especificó una ubicación no válida. 400 InvalidServerName: nombre de servidor no válido especificado. 400 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido. 400 TokenTooLong: el token proporcionado es demasiado largo. 400 RegionDoesNotAllowProvisioning: la ubicación seleccionada no acepta nuevos servidores de Windows Azure SQL Database. Esto puede cambiar más adelante. 400 ServerNotFound: no se encontró el servidor solicitado. 400 InvalidMinimalTlsVersion: versión mínima mínima de TLS no válida. 400 InvalidExternalAdministratorLogin: nombre de inicio de sesión de administrador externo no válido o que falta. 400 InvalidExternalAdministratorSid: identificador de objeto de administrador externo no válido o que falta. 400 InvalidExternalAdministratorTenantId: identificador de inquilino de administrador externo no válido o que falta. 400 ExternalAdministratorPrincipalType: tipo principal de administrador externo no válido o que falta. Seleccione en Usuario, Aplicación o Grupo. 400 MissingExternalAdministratorWithAadOnlyAuth: para usar la autenticación solo de Azure AD, proporcione los detalles de un administrador externo. 400 ExternalAdministratorLoginSameAsSqlAdmin: los nombres del administrador de Azure Active Directory y de la cuenta de administrador del servidor deben ser diferentes. Proporcione valores diferentes. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados. 404 OperationIdNotFound: la operación con id. no existe. 404 SubscriptionNotFound: no se encontró la suscripción solicitada. 409 OperationCancelled: el usuario ha cancelado la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso. 409 UpsertLogicalServerRequestAlreadyInProgress: una solicitud de servidor lógico en curso ya está en curso, vuelva a intentar la solicitud más tarde. 409 ServerDisabled: el servidor está deshabilitado. 409 ConflictingServerOperation: una operación está actualmente en curso para el servidor. 409 SubscriptionDisabled: la suscripción está deshabilitada. 409 ServerQuotaExceeded: el servidor no se puede agregar a una suscripción porque superará la cuota. 409 ServerAlreadyExists: nombre de servidor duplicado. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 ConflictingSubscriptionOperation: una operación está actualmente en curso para la suscripción. 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación y, 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

Ejemplos

Create server

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


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

Respuesta de muestra

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

Definiciones

Nombre	Description
AdministratorType	Tipo del administrador del servidor.
IdentityType	Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.
PrincipalType	Tipo principal del administrador del servidor.
PrivateEndpointConnectionProperties	Propiedades de una conexión de punto de conexión privado.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Estado de la conexión de punto de conexión privado.
PrivateLinkServiceConnectionStateActionsRequire	Las acciones necesarias para la conexión del servicio Private Link.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	Estado de conexión del servicio Private Link.
ResourceIdentity	Configuración de identidad de Azure Active Directory para un recurso.
Server	Un servidor de base de datos Azure SQL.
ServerExternalAdministrator	Propiedades de un administrador de Active Directory.
ServerNetworkAccessFlag	Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".
ServerPrivateEndpointConnection	Una conexión de punto de conexión privado en un servidor
ServerWorkspaceFeature	Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo
UserIdentity	Configuración de identidad de Azure Active Directory para un recurso.

AdministratorType

Tipo del administrador del servidor.

Nombre	Tipo	Description
ActiveDirectory	string

IdentityType

Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.

Nombre	Tipo	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PrincipalType

Tipo principal del administrador del servidor.

Nombre	Tipo	Description
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

Propiedades de una conexión de punto de conexión privado.

Nombre	Tipo	Description
groupIds	string[]	Identificadores de grupo.
privateEndpoint	PrivateEndpointProperty	Punto de conexión privado al que pertenece la conexión.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Estado de conexión de la conexión del punto de conexión privado.
provisioningState	PrivateEndpointProvisioningState	Estado de la conexión de punto de conexión privado.

PrivateEndpointProperty

Nombre	Tipo	Description
id	string	Identificador de recurso del punto de conexión privado.

PrivateEndpointProvisioningState

Estado de la conexión de punto de conexión privado.

Nombre	Tipo	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

Las acciones necesarias para la conexión del servicio Private Link.

Nombre	Tipo	Description
None	string

PrivateLinkServiceConnectionStateProperty

Nombre	Tipo	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Las acciones necesarias para la conexión del servicio Private Link.
description	string	Descripción de la conexión del servicio private link.
status	PrivateLinkServiceConnectionStateStatus	Estado de conexión del servicio Private Link.

PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio Private Link.

Nombre	Tipo	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

Configuración de identidad de Azure Active Directory para un recurso.

Nombre	Tipo	Description
principalId	string	Identificador de entidad de seguridad de Azure Active Directory.
tenantId	string	Identificador de inquilino de Azure Active Directory.
type	IdentityType	Tipo de identidad. Establézcalo en "SystemAssigned" para crear y asignar automáticamente una entidad de seguridad de Azure Active Directory para el recurso.
userAssignedIdentities	<string, UserIdentity>	Identificadores de recurso de las identidades asignadas por el usuario que se van a usar

Server

Un servidor de base de datos Azure SQL.

Nombre	Tipo	Description
id	string	Identificador del recurso.
identity	ResourceIdentity	Identidad de Azure Active Directory del servidor.
kind	string	Tipo de sql Server. Estos son los metadatos que se usan para la experiencia de Azure Portal.
location	string	Ubicación del recurso
name	string	Nombre del recurso.
properties.administratorLogin	string	Nombre de usuario del administrador para el servidor. Una vez creado, no se puede cambiar.
properties.administratorLoginPassword	string	Contraseña de inicio de sesión del administrador (necesaria para la creación del servidor).
properties.administrators	ServerExternalAdministrator	Administrador de Azure Active Directory del servidor.
properties.federatedClientId	string	El identificador de cliente que se usa para el escenario de CMK entre inquilinos
properties.fullyQualifiedDomainName	string	Nombre de dominio completo del servidor.
properties.keyId	string	URI de CMK de la clave que se va a usar para el cifrado.
properties.minimalTlsVersion	string	Versión mínima de TLS. Valores permitidos: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId	string	Identificador de recurso de una identidad asignada por el usuario que se va a usar de forma predeterminada.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lista de conexiones de punto de conexión privado en un servidor
properties.publicNetworkAccess	ServerNetworkAccessFlag	Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Si se va a restringir o no el acceso de red saliente para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".
properties.state	string	Estado del servidor.
properties.version	string	Versión del servidor.
properties.workspaceFeature	ServerWorkspaceFeature	Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo
tags	object	Etiquetas del recurso.
type	string	Tipo de recurso.

ServerExternalAdministrator

Propiedades de un administrador de Active Directory.

Nombre	Tipo	Description
administratorType	AdministratorType	Tipo del administrador del servidor.
azureADOnlyAuthentication	boolean	Autenticación solo de Azure Active Directory habilitada.
login	string	Nombre de inicio de sesión del administrador del servidor.
principalType	PrincipalType	Tipo principal del administrador del servidor.
sid	string	SID (id. de objeto) del administrador del servidor.
tenantId	string	Id. de inquilino del administrador.

ServerNetworkAccessFlag

Si se permite o no el acceso al punto de conexión público para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

Nombre	Tipo	Description
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

Una conexión de punto de conexión privado en un servidor

Nombre	Tipo	Description
id	string	Identificador del recurso.
properties	PrivateEndpointConnectionProperties	Propiedades de conexión de punto de conexión privado

ServerWorkspaceFeature

Si el servidor existente tiene o no un área de trabajo creada y si permite la conexión desde el área de trabajo

Nombre	Tipo	Description
Connected	string
Disconnected	string

UserIdentity