Servers - Update

Actualiza un servidor.

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

Parámetros de identificador URI

Name In Required Type 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

Name Type Description
identity

Identidad 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

Identidad Azure Active Directory del servidor.

properties.federatedClientId
  • string

Identificador de cliente usado 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 usará de forma predeterminada.

properties.publicNetworkAccess

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

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

Name Type Description
200 OK

Se actualizó correctamente el servidor.

202 Accepted

Aceptado

Other Status Codes

Respuestas de error: ***

  • 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 ProvisioningDisabled: muestra el mensaje de error del autorizador de la operación de recursos tal cual, sin cambios

  • 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 PasswordTooShort: la contraseña proporcionada es demasiado corta

  • 400 AadOnlyAuthenticationIsEnabled: solo se habilita la autenticación Azure Active Directory. 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 SubscriptionNotFound: no se encontró la suscripción solicitada.

  • 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 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 de entidad de seguridad de administrador externo no válida 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.

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

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

Ejemplos

Update a server

Sample Request

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

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

Sample Response

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

Definiciones

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 de entidad de seguridad del administrador del servidor.

PrivateEndpointConnectionProperties

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

PrivateEndpointProperty
PrivateEndpointProvisioningState

Estado de la conexión del 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

Azure Active Directory configuración de identidad de un recurso.

Server

Un servidor Azure SQL Database.

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

ServerUpdate

Solicitud de actualización de un servidor Azure SQL Database.

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

Azure Active Directory configuración de identidad de un recurso.

AdministratorType

Tipo del administrador del servidor.

Name Type 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.

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

PrincipalType

Tipo de entidad de seguridad del administrador del servidor.

Name Type Description
Application
  • string
Group
  • string
User
  • string

PrivateEndpointConnectionProperties

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

Name Type Description
privateEndpoint

Punto de conexión privado al que pertenece la conexión.

privateLinkServiceConnectionState

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

provisioningState

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

PrivateEndpointProperty

Name Type Description
id
  • string

Identificador de recurso del punto de conexión privado.

PrivateEndpointProvisioningState

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

Name Type Description
Approving
  • string
Dropping
  • string
Failed
  • string
Ready
  • string
Rejecting
  • string

PrivateLinkServiceConnectionStateActionsRequire

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

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

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

description
  • string

Descripción de la conexión del servicio Private Link.

status

Estado de conexión del servicio Private Link.

PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio Private Link.

Name Type Description
Approved
  • string
Disconnected
  • string
Pending
  • string
Rejected
  • string

ResourceIdentity

Azure Active Directory configuración de identidad de un recurso.

Name Type Description
principalId
  • string

Identificador de Azure Active Directory entidad de seguridad.

tenantId
  • string

Identificador de inquilino de Azure Active Directory.

type

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

Identificadores de recurso de las identidades asignadas por el usuario que se van a usar

Server

Un servidor Azure SQL Database.

Name Type Description
id
  • string

Identificador del recurso.

identity

Identidad 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

Identidad Azure Active Directory del servidor.

properties.federatedClientId
  • string

Identificador de cliente usado 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 usará de forma predeterminada.

properties.privateEndpointConnections

Lista de conexiones de punto de conexión privado en un servidor

properties.publicNetworkAccess

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

Si se va a restringir o no el acceso de red saliente a 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

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.

Name Type Description
administratorType

Tipo del administrador del servidor.

azureADOnlyAuthentication
  • boolean

Azure Active Directory solo la autenticación habilitada.

login
  • string

Nombre de inicio de sesión del administrador del servidor.

principalType

Tipo de entidad de seguridad 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".

Name Type Description
Disabled
  • string
Enabled
  • string

ServerPrivateEndpointConnection

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

Name Type Description
id
  • string

Identificador del recurso.

properties

Propiedades de conexión de punto de conexión privado

ServerUpdate

Solicitud de actualización de un servidor Azure SQL Database.

Name Type Description
identity

Identidad 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

Identidad Azure Active Directory del servidor.

properties.federatedClientId
  • string

Identificador de cliente usado 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 usará de forma predeterminada.

properties.privateEndpointConnections

Lista de conexiones de punto de conexión privado en un servidor

properties.publicNetworkAccess

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

Si se va a restringir o no el acceso de red saliente a 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

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.

ServerWorkspaceFeature

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

Name Type Description
Connected
  • string
Disconnected
  • string

UserIdentity

Azure Active Directory configuración de identidad de un recurso.

Name Type Description
clientId
  • string

Identificador de cliente Azure Active Directory.

principalId
  • string

Identificador de Azure Active Directory entidad de seguridad.