Servers - Update

Service:: SQL Database

API-versie:: 2023-08-01

Hiermee wordt een server bijgewerkt.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Type	Description
identity	ResourceIdentity	Serveridentiteit
properties.administratorLogin	string	Gebruikersnaam van de beheerder voor de server. Zodra het is gemaakt, kan deze niet meer worden gewijzigd.
properties.administratorLoginPassword	string	Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van de server).
properties.administrators	ServerExternalAdministrator	De Azure Active Directory-beheerder van de server. Dit kan alleen worden gebruikt tijdens het maken van de server. Als deze wordt gebruikt voor het bijwerken van de server, wordt deze genegeerd of resulteert dit in een fout. Voor updates moeten afzonderlijke API's worden gebruikt.
properties.federatedClientId	string (uuid)	De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants
properties.isIPv6Enabled	ServerNetworkAccessFlag	Of iPv6-ondersteuning voor deze server al dan niet moet worden ingeschakeld. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.keyId	string	Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.
properties.minimalTlsVersion	MinimalTlsVersion	Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Of openbare eindpunttoegang wel of niet is toegestaan voor deze server. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' of 'SecuredByPerimeter' zijn
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Hiermee wordt aangegeven of uitgaande netwerktoegang voor deze server al dan niet wordt beperkt. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.version	string	De versie van de server.
tags	object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	Server	De server is bijgewerkt.
202 Accepted		Geaccepteerd Kopteksten Location: string
Other Status Codes	ErrorResponse	Foutreacties: *** 400 ManagedInstanceStoppingOrStopped - Conflicterende bewerking verzonden terwijl het exemplaar de status gestopt/gestopt heeft 400 ManagedInstanceStarting - Conflicterende bewerking verzonden terwijl het exemplaar de beginstatus heeft 400 NameAlreadyExistsSoftDeleted - De aangevraagde servernaam wordt genomen door een server met de status Voorlopig verwijderd. De server leegmaken of herstellen om de blokkering op te heffen. 400 MissingIdentityId - Er wordt geen door de gebruiker toegewezen identiteit opgegeven wanneer het identiteitstype is ingesteld op UserAssigned 400 InvalidPrimaryIdentityId - Gebruiker biedt een waarde voor PrimaryUserIdentityId, maar hetzelfde wordt niet vermeld in de parameter IdentityId 400 PECsNotExistingToDenyPublicNetworkAccess - Kan openbare netwerktoegang weigeren niet instellen op Ja, omdat er geen privé-eindpunt is ingeschakeld voor toegang tot de server. Stel privé-eindpunten in en voer de bewerking opnieuw uit (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists : de opgegeven naam bestaat al. 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId geleverd door de gebruiker heeft geen toegang tot KeyId opgegeven 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId geleverd door de gebruiker heeft geen toegang tot KeyId opgegeven 400 ProvisioningDisabled - Geeft het foutbericht weer van de resourcebewerking autor zoals dat is, zonder wijzigingen 400 PrimaryIdentityMissingPermissionForKeyId - KeyId wordt geleverd door de gebruiker tijdens het maken, maar PrimaryUserAssignedIdentityId is niet opgegeven in de API-aanroep 400 InvalidIdentityTypeForKeyId - KeyId wordt geleverd door de gebruiker tijdens het maken, maar het identiteitstype is niet ingesteld op UserAssigned 400 InvalidLoginName : de opgegeven aanmeldingsnaam is ongeldig. 400 InvalidUsername - Opgegeven gebruikersnaam bevat ongeldige tekens. 400 Ipv6FeatureNotEnabled - Gebruiker heeft geprobeerd Ipv6-ondersteuning in te schakelen op de server zonder functievlag in te schakelen voor het abonnement of de functieondersteuning is momenteel uitgeschakeld in de regio. 400 PasswordTooShort - Het opgegeven wachtwoord is te kort 400 AadOnlyAuthenticationIsEnabled - Alleen verificatie van Azure Active Directory is ingeschakeld. Neem contact op met uw systeembeheerder. 400 RegionDoesNotSupportVersion - Een gebruiker heeft geprobeerd een server van een opgegeven versie te maken op een locatie waar die serverversie niet wordt ondersteund. 400 PasswordTooLong - Het opgegeven wachtwoord is te lang. 400 PasswordNotComplex - Het opgegeven wachtwoord is niet complex genoeg. 400 InvalidParameterValue - Er is een ongeldige waarde aan een parameter gegeven. 400 InvalidLocation - Er is een ongeldige locatie opgegeven. 400 InvalidServerName - Ongeldige servernaam opgegeven. 400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken. 400 TokenTooLong - Het opgegeven token is te lang. 400 CMKOperationNotAllowed : gebruiker heeft geprobeerd een bewerking uit te voeren op de server wanneer de server geen Toegang tot Azure Key Vault heeft. 400 ServerNotFound - De aangevraagde server is niet gevonden. 400 RegionDoesNotAllowProvisioning : de geselecteerde locatie accepteert geen nieuwe Windows Azure SQL Database-servers. Dit kan later worden gewijzigd. 400 InvalidMinimalTlsVersion - Ongeldige minimale TLS-versie. 400 InvalidExternalAdministratorLogin - Ongeldige of ontbrekende aanmeldingsnaam van externe beheerder. 400 InvalidExternalAdministratorSid - Ongeldige of ontbrekende object-id van externe beheerder. 400 InvalidExternalAdministratorTenantId - Ongeldige of ontbrekende tenant-id van externe beheerder. 400 ExternalAdministratorPrincipalType : ongeldig of ontbrekend type externe administrator-principal. Selecteer een gebruiker, toepassing of groep. 400 MissingExternalAdministratorWithAadOnlyAuth : als u alleen Verificatie van Azure AD wilt gebruiken, geeft u details op van een externe beheerder. 400 ExternalAdministratorLoginSameAsSqlAdmin: de namen van de Azure Active Directory-beheerder en van het serverbeheerdersaccount moeten afwijken. Geef verschillende waarden op. 400 ServerAdministratorNameAlreadyExists - Gebruiker heeft geprobeerd de externe beheerder in te stellen en de principal-naam bestaat al in de hoofddatabase. 404 ServerNotInSubscriptionResourceGroup - Opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 OperationIdNotFound - De bewerking met id bestaat niet. 404 SubscriptionNotFound - Het aangevraagde abonnement is niet gevonden. 409 CannotCancelOperation - De beheerbewerking heeft een status die niet kan worden geannuleerd. 409 OperationCancelled - De bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 409 UpsertLogicalServerRequestAlreadyInProgress: er wordt al een lopende logische serveraanvraag uitgevoerd. Probeer uw aanvraag later opnieuw. 409 ServerDisabled - Server is uitgeschakeld. 409 ConflictingServerOperation: er wordt momenteel een bewerking uitgevoerd voor de server. 409 SubscriptionDisabled - Abonnement is uitgeschakeld. 409 ServerQuotaExceeded - Server kan niet worden toegevoegd aan een abonnement omdat het quotum wordt overschreden. 409 ServerAlreadyExists - Dubbele servernaam. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 ConflictingSubscriptionOperation: er wordt momenteel een bewerking uitgevoerd voor het abonnement. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en wordt automatisch teruggedraaid. Voer de bewerking opnieuw uit. 503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen worden verwerkt door beschikbare resources. 503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen worden verwerkt door beschikbare resources.

Name

Type

Description

200 OK

Server

De server is bijgewerkt.

202 Accepted

Geaccepteerd

Kopteksten

Location: string

Other Status Codes

ErrorResponse

Foutreacties: ***

400 ManagedInstanceStoppingOrStopped - Conflicterende bewerking verzonden terwijl het exemplaar de status gestopt/gestopt heeft
400 ManagedInstanceStarting - Conflicterende bewerking verzonden terwijl het exemplaar de beginstatus heeft
400 NameAlreadyExistsSoftDeleted - De aangevraagde servernaam wordt genomen door een server met de status Voorlopig verwijderd. De server leegmaken of herstellen om de blokkering op te heffen.
400 MissingIdentityId - Er wordt geen door de gebruiker toegewezen identiteit opgegeven wanneer het identiteitstype is ingesteld op UserAssigned
400 InvalidPrimaryIdentityId - Gebruiker biedt een waarde voor PrimaryUserIdentityId, maar hetzelfde wordt niet vermeld in de parameter IdentityId
400 PECsNotExistingToDenyPublicNetworkAccess - Kan openbare netwerktoegang weigeren niet instellen op Ja, omdat er geen privé-eindpunt is ingeschakeld voor toegang tot de server. Stel privé-eindpunten in en voer de bewerking opnieuw uit (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database).
400 NameAlreadyExists : de opgegeven naam bestaat al.
400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId geleverd door de gebruiker heeft geen toegang tot KeyId opgegeven
400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId geleverd door de gebruiker heeft geen toegang tot KeyId opgegeven
400 ProvisioningDisabled - Geeft het foutbericht weer van de resourcebewerking autor zoals dat is, zonder wijzigingen
400 PrimaryIdentityMissingPermissionForKeyId - KeyId wordt geleverd door de gebruiker tijdens het maken, maar PrimaryUserAssignedIdentityId is niet opgegeven in de API-aanroep
400 InvalidIdentityTypeForKeyId - KeyId wordt geleverd door de gebruiker tijdens het maken, maar het identiteitstype is niet ingesteld op UserAssigned
400 InvalidLoginName : de opgegeven aanmeldingsnaam is ongeldig.
400 InvalidUsername - Opgegeven gebruikersnaam bevat ongeldige tekens.
400 Ipv6FeatureNotEnabled - Gebruiker heeft geprobeerd Ipv6-ondersteuning in te schakelen op de server zonder functievlag in te schakelen voor het abonnement of de functieondersteuning is momenteel uitgeschakeld in de regio.
400 PasswordTooShort - Het opgegeven wachtwoord is te kort
400 AadOnlyAuthenticationIsEnabled - Alleen verificatie van Azure Active Directory is ingeschakeld. Neem contact op met uw systeembeheerder.
400 RegionDoesNotSupportVersion - Een gebruiker heeft geprobeerd een server van een opgegeven versie te maken op een locatie waar die serverversie niet wordt ondersteund.
400 PasswordTooLong - Het opgegeven wachtwoord is te lang.
400 PasswordNotComplex - Het opgegeven wachtwoord is niet complex genoeg.
400 InvalidParameterValue - Er is een ongeldige waarde aan een parameter gegeven.
400 InvalidLocation - Er is een ongeldige locatie opgegeven.
400 InvalidServerName - Ongeldige servernaam opgegeven.
400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken.
400 TokenTooLong - Het opgegeven token is te lang.
400 CMKOperationNotAllowed : gebruiker heeft geprobeerd een bewerking uit te voeren op de server wanneer de server geen Toegang tot Azure Key Vault heeft.
400 ServerNotFound - De aangevraagde server is niet gevonden.
400 RegionDoesNotAllowProvisioning : de geselecteerde locatie accepteert geen nieuwe Windows Azure SQL Database-servers. Dit kan later worden gewijzigd.
400 InvalidMinimalTlsVersion - Ongeldige minimale TLS-versie.
400 InvalidExternalAdministratorLogin - Ongeldige of ontbrekende aanmeldingsnaam van externe beheerder.
400 InvalidExternalAdministratorSid - Ongeldige of ontbrekende object-id van externe beheerder.
400 InvalidExternalAdministratorTenantId - Ongeldige of ontbrekende tenant-id van externe beheerder.
400 ExternalAdministratorPrincipalType : ongeldig of ontbrekend type externe administrator-principal. Selecteer een gebruiker, toepassing of groep.
400 MissingExternalAdministratorWithAadOnlyAuth : als u alleen Verificatie van Azure AD wilt gebruiken, geeft u details op van een externe beheerder.
400 ExternalAdministratorLoginSameAsSqlAdmin: de namen van de Azure Active Directory-beheerder en van het serverbeheerdersaccount moeten afwijken. Geef verschillende waarden op.
400 ServerAdministratorNameAlreadyExists - Gebruiker heeft geprobeerd de externe beheerder in te stellen en de principal-naam bestaat al in de hoofddatabase.
404 ServerNotInSubscriptionResourceGroup - Opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.
404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden
404 OperationIdNotFound - De bewerking met id bestaat niet.
404 SubscriptionNotFound - Het aangevraagde abonnement is niet gevonden.
409 CannotCancelOperation - De beheerbewerking heeft een status die niet kan worden geannuleerd.
409 OperationCancelled - De bewerking is geannuleerd door de gebruiker.
409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource.
409 UpsertLogicalServerRequestAlreadyInProgress: er wordt al een lopende logische serveraanvraag uitgevoerd. Probeer uw aanvraag later opnieuw.
409 ServerDisabled - Server is uitgeschakeld.
409 ConflictingServerOperation: er wordt momenteel een bewerking uitgevoerd voor de server.
409 SubscriptionDisabled - Abonnement is uitgeschakeld.
409 ServerQuotaExceeded - Server kan niet worden toegevoegd aan een abonnement omdat het quotum wordt overschreden.
409 ServerAlreadyExists - Dubbele servernaam.
429 SubscriptionTooManyCreateUpdateRequests - Aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.
429 SubscriptionTooManyRequests : aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.
429 SubscriptionTooManyCreateUpdateRequests - Aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.
429 SubscriptionTooManyRequests : aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.
429 ConflictingSubscriptionOperation: er wordt momenteel een bewerking uitgevoerd voor het abonnement.
500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en wordt automatisch teruggedraaid. Voer de bewerking opnieuw uit.
503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen worden verwerkt door beschikbare resources.
503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen worden verwerkt door beschikbare resources.

Voorbeelden

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

Voorbeeldrespons

Statuscode:: 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"
          }
        }
      }
    ]
  }
}

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

Definities

Name	Description
AdministratorType	Type van de serverbeheerder.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
ExternalGovernanceStatus	Status van extern beheer.
IdentityType	Het identiteitstype. Stel dit in op SystemAssigned om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen.
MinimalTlsVersion	Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'
PrincipalType	Principal-type van de serverbeheerder.
PrivateEndpointConnectionProperties	Eigenschappen van een privé-eindpuntverbinding.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Status van de privé-eindpuntverbinding.
PrivateLinkServiceConnectionStateActionsRequire	De acties die nodig zijn voor de private link-serviceverbinding.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	De verbindingsstatus van de Private Link-service.
ResourceIdentity	Azure Active Directory-identiteitsconfiguratie voor een resource.
Server	Een Azure SQL Database-server.
ServerExternalAdministrator	Eigenschappen van een Active Directory-beheerder.
ServerNetworkAccessFlag	Hiermee wordt aangegeven of uitgaande netwerktoegang voor deze server al dan niet wordt beperkt. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
ServerPrivateEndpointConnection	Een privé-eindpuntverbinding onder een server
ServerPublicNetworkAccessFlag	Of openbare eindpunttoegang wel of niet is toegestaan voor deze server. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' of 'SecuredByPerimeter' zijn
ServerUpdate	Een updateaanvraag voor een Azure SQL Database-server.
ServerWorkspaceFeature	Of er al dan niet een bestaande server een werkruimte is gemaakt en of er verbinding vanuit de werkruimte is toegestaan
UserIdentity	Azure Active Directory-identiteitsconfiguratie voor een resource.

AdministratorType

Inventarisatie

Type van de serverbeheerder.

Waarde	Description
ActiveDirectory

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

ExternalGovernanceStatus

Inventarisatie

Status van extern beheer.

Waarde	Description
Enabled
Disabled

IdentityType

Inventarisatie

Het identiteitstype. Stel dit in op SystemAssigned om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen.

Waarde	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

MinimalTlsVersion

Inventarisatie

Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'

Waarde	Description
None
1.0
1.1
1.2
1.3

PrincipalType

Inventarisatie

Principal-type van de serverbeheerder.

Waarde	Description
User
Group
Application

PrivateEndpointConnectionProperties

Object

Eigenschappen van een privé-eindpuntverbinding.

Name	Type	Description
groupIds	string[]	Groeps-id's.
privateEndpoint	PrivateEndpointProperty	Privé-eindpunt waartoe de verbinding behoort.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Verbindingsstatus van de privé-eindpuntverbinding.
provisioningState	PrivateEndpointProvisioningState	Status van de privé-eindpuntverbinding.

PrivateEndpointProperty

Object

Name	Type	Description
id	string	Resource-id van het privé-eindpunt.

PrivateEndpointProvisioningState

Inventarisatie

Status van de privé-eindpuntverbinding.

Waarde	Description
Approving
Ready
Dropping
Failed
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Inventarisatie

De acties die nodig zijn voor de private link-serviceverbinding.

Waarde	Description
None

PrivateLinkServiceConnectionStateProperty

Object

Name	Type	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	De acties die nodig zijn voor de private link-serviceverbinding.
description	string	De beschrijving van de private link-serviceverbinding.
status	PrivateLinkServiceConnectionStateStatus	De verbindingsstatus van de Private Link-service.

PrivateLinkServiceConnectionStateStatus

Inventarisatie

De verbindingsstatus van de Private Link-service.

Waarde	Description
Approved
Pending
Rejected
Disconnected

ResourceIdentity

Object

Azure Active Directory-identiteitsconfiguratie voor een resource.

Name	Type	Description
principalId	string (uuid)	De principal-id van Azure Active Directory.
tenantId	string (uuid)	De tenant-id van Azure Active Directory.
type	IdentityType	Het identiteitstype. Stel dit in op SystemAssigned om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen.
userAssignedIdentities	<string, UserIdentity>	De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt

Server

Object

Een Azure SQL Database-server.

Name	Type	Description
id	string	Resource-id.
identity	ResourceIdentity	De Azure Active Directory-identiteit van de server.
kind	string	Soort SQL-server. Dit zijn metagegevens die worden gebruikt voor de Azure Portal-ervaring.
location	string	Resourcelocatie.
name	string	Resourcenaam.
properties.administratorLogin	string	Gebruikersnaam van de beheerder voor de server. Zodra het is gemaakt, kan deze niet meer worden gewijzigd.
properties.administratorLoginPassword	string	Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van de server).
properties.administrators	ServerExternalAdministrator	De Azure Active Directory-beheerder van de server. Dit kan alleen worden gebruikt tijdens het maken van de server. Als deze wordt gebruikt voor het bijwerken van de server, wordt deze genegeerd of resulteert dit in een fout. Voor updates moeten afzonderlijke API's worden gebruikt.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Status van extern beheer.
properties.federatedClientId	string (uuid)	De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants
properties.fullyQualifiedDomainName	string	De volledig gekwalificeerde domeinnaam van de server.
properties.isIPv6Enabled	ServerNetworkAccessFlag	Of iPv6-ondersteuning voor deze server al dan niet moet worden ingeschakeld. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.keyId	string	Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.
properties.minimalTlsVersion	MinimalTlsVersion	Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lijst met privé-eindpuntverbindingen op een server
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Of openbare eindpunttoegang wel of niet is toegestaan voor deze server. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' of 'SecuredByPerimeter' zijn
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Hiermee wordt aangegeven of uitgaande netwerktoegang voor deze server al dan niet wordt beperkt. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.state	string	De status van de server.
properties.version	string	De versie van de server.
properties.workspaceFeature	ServerWorkspaceFeature	Of er al dan niet een bestaande server een werkruimte is gemaakt en of er verbinding vanuit de werkruimte is toegestaan
tags	object	Resourcetags.
type	string	Resourcetype.

ServerExternalAdministrator

Object

Eigenschappen van een Active Directory-beheerder.

Name	Type	Description
administratorType	AdministratorType	Type van de serverbeheerder.
azureADOnlyAuthentication	boolean	Alleen azure Active Directory-verificatie ingeschakeld.
login	string	Aanmeldingsnaam van de serverbeheerder.
principalType	PrincipalType	Principal-type van de serverbeheerder.
sid	string (uuid)	SID (object-id) van de serverbeheerder.
tenantId	string (uuid)	Tenant-id van de beheerder.

ServerNetworkAccessFlag

Inventarisatie

Hiermee wordt aangegeven of uitgaande netwerktoegang voor deze server al dan niet wordt beperkt. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn

Waarde	Description
Enabled
Disabled

ServerPrivateEndpointConnection

Object

Een privé-eindpuntverbinding onder een server

Name	Type	Description
id	string	Resource-id.
properties	PrivateEndpointConnectionProperties	Eigenschappen van privé-eindpuntverbinding

ServerPublicNetworkAccessFlag

Inventarisatie

Of openbare eindpunttoegang wel of niet is toegestaan voor deze server. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' of 'SecuredByPerimeter' zijn

Waarde	Description
Enabled
Disabled
SecuredByPerimeter

ServerUpdate

Object

Een updateaanvraag voor een Azure SQL Database-server.

Name	Type	Description
identity	ResourceIdentity	Serveridentiteit
properties.administratorLogin	string	Gebruikersnaam van de beheerder voor de server. Zodra het is gemaakt, kan deze niet meer worden gewijzigd.
properties.administratorLoginPassword	string	Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van de server).
properties.administrators	ServerExternalAdministrator	De Azure Active Directory-beheerder van de server. Dit kan alleen worden gebruikt tijdens het maken van de server. Als deze wordt gebruikt voor het bijwerken van de server, wordt deze genegeerd of resulteert dit in een fout. Voor updates moeten afzonderlijke API's worden gebruikt.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Status van extern beheer.
properties.federatedClientId	string (uuid)	De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants
properties.fullyQualifiedDomainName	string	De volledig gekwalificeerde domeinnaam van de server.
properties.isIPv6Enabled	ServerNetworkAccessFlag	Of iPv6-ondersteuning voor deze server al dan niet moet worden ingeschakeld. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.keyId	string	Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.
properties.minimalTlsVersion	MinimalTlsVersion	Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lijst met privé-eindpuntverbindingen op een server
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Of openbare eindpunttoegang wel of niet is toegestaan voor deze server. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' of 'SecuredByPerimeter' zijn
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Hiermee wordt aangegeven of uitgaande netwerktoegang voor deze server al dan niet wordt beperkt. Waarde is optioneel, maar als deze wordt doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.state	string	De status van de server.
properties.version	string	De versie van de server.
properties.workspaceFeature	ServerWorkspaceFeature	Of er al dan niet een bestaande server een werkruimte is gemaakt en of er verbinding vanuit de werkruimte is toegestaan
tags	object	Resourcetags.

ServerWorkspaceFeature

Inventarisatie

Of er al dan niet een bestaande server een werkruimte is gemaakt en of er verbinding vanuit de werkruimte is toegestaan

Waarde	Description
Connected
Disconnected

UserIdentity

Object

Azure Active Directory-identiteitsconfiguratie voor een resource.

Name	Type	Description
clientId	string (uuid)	De Azure Active Directory-client-id.
principalId	string (uuid)	De principal-id van Azure Active Directory.

Delen via

Servers - Update

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

Update a server

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AdministratorType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

IdentityType

MinimalTlsVersion

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerPublicNetworkAccessFlag

ServerUpdate

ServerWorkspaceFeature

UserIdentity