Servers - Update

Uppdaterar en server.

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

URI-parametrar

Name In Required Type Description
resourceGroupName
path True
  • string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

serverName
path True
  • string

Namnet på servern.

subscriptionId
path True
  • string

Det prenumerations-ID som identifierar en Azure-prenumeration.

api-version
query True
  • string

DEN API-version som ska användas för begäran.

Begärandetext

Name Type Description
identity

Serveridentitet

properties.administratorLogin
  • string

Administratörsanvändarnamn för servern. När den har skapats kan den inte ändras.

properties.administratorLoginPassword
  • string

Administratörens inloggningslösenord (krävs för att skapa servern).

properties.administrators

Serverns Azure Active Directory-administratör.

properties.federatedClientId
  • string

Klient-ID:t som används för CMK-scenario mellan klientorganisationer

properties.keyId
  • string

En CMK-URI för nyckeln som ska användas för kryptering.

properties.minimalTlsVersion
  • string

Minimal TLS-version. Tillåtna värden: "1.0", "1.1", "1.2"

properties.primaryUserAssignedIdentityId
  • string

Resurs-ID för en användartilldelad identitet som ska användas som standard.

properties.publicNetworkAccess

Om offentlig slutpunktsåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"

properties.restrictOutboundNetworkAccess

Om du vill begränsa utgående nätverksåtkomst för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat

properties.version
  • string

Serverns version.

tags
  • object

Resurstaggar.

Svar

Name Type Description
200 OK

Servern har uppdaterats.

202 Accepted

Har godkänts

Other Status Codes

Felsvar: ***

  • 400 MissingIdentityId – Ingen användartilldelad identitet anges när identitetstypen är inställd på UserAssigned

  • 400 InvalidPrimaryIdentityId – Användaren anger ett värde för PrimaryUserIdentityId men samma värde visas inte i parametern IdentityId

  • 400 PECsNotExistingToDenyPublicNetworkAccess – Det går inte att ange Neka åtkomst till offentligt nätverk till Ja eftersom det inte finns någon privat slutpunkt aktiverad för åtkomst till servern. Konfigurera privata slutpunkter och försök igen (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database).

  • 400 NameAlreadyExists – Det angivna namnet finns redan.

  • 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId som tillhandahålls av användaren har inte åtkomst till KeyId

  • 400 MissingPrimaryIdentity – PrimaryUserAssignedIdentityId som tillhandahålls av användaren har inte åtkomst till KeyId

  • 400 ProvisioningDisabled – visar felmeddelandet från resursåtgärden authorizer som den är, utan ändringar

  • 400 PrimaryIdentityMissingPermissionForKeyId – KeyId tillhandahålls av användaren under skapande men PrimaryUserAssignedIdentityId anges inte i API-anropet

  • 400 InvalidIdentityTypeForKeyId – KeyId tillhandahålls av användaren under skapande men identitetstypen är inte inställd på "UserAssigned"

  • 400 InvalidLoginName – det angivna inloggningsnamnet är ogiltigt.

  • 400 InvalidUsername – Angivet användarnamn innehåller ogiltiga tecken.

  • 400 Ipv6FeatureNotEnabled – Användaren försökte aktivera Ipv6-stöd på servern utan att aktivera funktionsflaggan för prenumerationen, eller så är funktionsstödet för närvarande inaktiverat i regionen.

  • 400 PasswordTooShort – Det angivna lösenordet är för kort

  • 400 AadOnlyAuthenticationIsEnabled – Azure Active Directory Endast autentisering är aktiverat. Kontakta systemadministratören.

  • 400 RegionDoesNotSupportVersion – En användare försökte skapa en server med en angiven version på en plats där serverversionen inte stöds.

  • 400 PasswordTooLong – Det angivna lösenordet är för långt.

  • 400 PasswordNotComplex – Det angivna lösenordet är inte tillräckligt komplext.

  • 400 InvalidParameterValue – ett ogiltigt värde angavs till en parameter.

  • 400 InvalidLocation – en ogiltig plats har angetts.

  • 400 InvalidServerName – Ogiltigt servernamn har angetts.

  • 400 InvalidIdentifier – identifieraren innehåller NULL eller ett ogiltigt unicode-tecken.

  • 400 TokenTooLong – den angivna token är för lång.

  • 400 RegionDoesNotAllowProvisioning – Den valda platsen accepterar inte nya Windows Azure SQL Database servrar. Detta kan ändras vid ett senare tillfälle.

  • 400 ServerNotFound – Den begärda servern hittades inte.

  • 400 InvalidMinimalTlsVersion – Ogiltig minimal TLS-version.

  • 400 InvalidExternalAdministratorLogin – Ogiltigt eller saknat inloggningsnamn för extern administratör.

  • 400 InvalidExternalAdministratorSid – Ogiltigt eller saknat objekt-ID för extern administratör.

  • 400 InvalidExternalAdministratorTenantId – Ogiltigt eller saknat klientorganisations-ID för extern administratör.

  • 400 ExternalAdministratorPrincipalType – Ogiltig eller saknad extern administratörshuvudnamnstyp. Välj från Användare, Program eller Grupp.

  • 400 MissingExternalAdministratorWithAadOnlyAuth – Ange information om en extern administratör för att kunna använda Azure AD endast autentisering.

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

  • 404 OperationIdNotFound – åtgärden med ID finns inte.

  • 404 SubscriptionNotFound – Det gick inte att hitta den begärda prenumerationen.

  • 409 OperationCancelled – åtgärden har avbrutits av användaren.

  • 409 OperationInterrupted – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs.

  • 409 UpsertLogicalServerRequestAlreadyInProgress – En pågående logisk serverbegäran pågår redan. Försök igen senare.

  • 409 ServerDisabled – Servern är inaktiverad.

  • 409 ConflictingServerOperation – en åtgärd pågår för närvarande för servern.

  • 409 SubscriptionDisabled – Prenumerationen är inaktiverad.

  • 409 ServerQuotaExceeded – Servern kan inte läggas till i en prenumeration eftersom den överskrider kvoten.

  • 409 ServerAlreadyExists – Duplicerat servernamn.

  • 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 ConflictingSubscriptionOperation – en åtgärd pågår för närvarande för prenumerationen.

  • 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen.

  • 503 TooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

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

Definitioner

AdministratorType

Typ av administratör för serverservern.

IdentityType

Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory huvudnamn för resursen.

PrincipalType

Huvudtyp för administratören för serverservern.

PrivateEndpointConnectionProperties

Egenskaper för en privat slutpunktsanslutning.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Tillstånd för den privata slutpunktsanslutningen.

PrivateLinkServiceConnectionStateActionsRequire

De åtgärder som krävs för privat länktjänstanslutning.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

Anslutningsstatus för tjänsten private link.

ResourceIdentity

Azure Active Directory identitetskonfiguration för en resurs.

Server

En Azure SQL Database-server.

ServerExternalAdministrator

Egenskaper för en active directory-administratör.

ServerNetworkAccessFlag

Om offentlig slutpunktsåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"

ServerPrivateEndpointConnection

En privat slutpunktsanslutning under en server

ServerUpdate

En uppdateringsbegäran för en Azure SQL Database-server.

ServerWorkspaceFeature

Om en befintlig server har en arbetsyta skapad eller inte och om den tillåter anslutning från arbetsytan

UserIdentity

Azure Active Directory identitetskonfiguration för en resurs.

AdministratorType

Typ av administratör för serverservern.

Name Type Description
ActiveDirectory
  • string

IdentityType

Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory huvudnamn för resursen.

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

PrincipalType

Huvudtyp för administratören för serverservern.

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

PrivateEndpointConnectionProperties

Egenskaper för en privat slutpunktsanslutning.

Name Type Description
groupIds
  • string[]

Grupp-ID:t.

privateEndpoint

Privat slutpunkt som anslutningen tillhör.

privateLinkServiceConnectionState

Anslutningstillstånd för den privata slutpunktsanslutningen.

provisioningState

Tillstånd för den privata slutpunktsanslutningen.

PrivateEndpointProperty

Name Type Description
id
  • string

Resurs-ID för den privata slutpunkten.

PrivateEndpointProvisioningState

Tillstånd för den privata slutpunktsanslutningen.

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

PrivateLinkServiceConnectionStateActionsRequire

De åtgärder som krävs för privat länktjänstanslutning.

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

De åtgärder som krävs för privat länktjänstanslutning.

description
  • string

Beskrivning av tjänstanslutningen för privat länk.

status

Anslutningsstatus för tjänsten private link.

PrivateLinkServiceConnectionStateStatus

Anslutningsstatus för tjänsten private link.

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

ResourceIdentity

Azure Active Directory identitetskonfiguration för en resurs.

Name Type Description
principalId
  • string

Det Azure Active Directory huvudnamns-ID:t.

tenantId
  • string

Azure Active Directory klientorganisations-ID.

type

Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory huvudnamn för resursen.

userAssignedIdentities

Resurs-ID:n för de användartilldelade identiteter som ska användas

Server

En Azure SQL Database-server.

Name Type Description
id
  • string

Resurs-ID.

identity

Serverns Azure Active Directory identitet.

kind
  • string

Typ av sql-server. Det här är metadata som används för Azure Portal upplevelse.

location
  • string

Resursplats.

name
  • string

Resursnamn.

properties.administratorLogin
  • string

Administratörsanvändarnamn för servern. När den har skapats kan den inte ändras.

properties.administratorLoginPassword
  • string

Administratörens inloggningslösenord (krävs för att skapa servern).

properties.administrators

Serverns Azure Active Directory-administratör.

properties.federatedClientId
  • string

Klient-ID:t som används för CMK-scenario mellan klientorganisationer

properties.fullyQualifiedDomainName
  • string

Serverns fullständigt kvalificerade domännamn.

properties.keyId
  • string

En CMK-URI för nyckeln som ska användas för kryptering.

properties.minimalTlsVersion
  • string

Minimal TLS-version. Tillåtna värden: "1.0", "1.1", "1.2"

properties.primaryUserAssignedIdentityId
  • string

Resurs-ID för en användartilldelad identitet som ska användas som standard.

properties.privateEndpointConnections

Lista över privata slutpunktsanslutningar på en server

properties.publicNetworkAccess

Om offentlig slutpunktsåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"

properties.restrictOutboundNetworkAccess

Om du vill begränsa utgående nätverksåtkomst för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"

properties.state
  • string

Serverns tillstånd.

properties.version
  • string

Serverns version.

properties.workspaceFeature

Om en befintlig server har en arbetsyta skapad eller inte och om den tillåter anslutning från arbetsytan

tags
  • object

Resurstaggar.

type
  • string

Resurstyp.

ServerExternalAdministrator

Egenskaper för en active directory-administratör.

Name Type Description
administratorType

Typ av administratör för serverservern.

azureADOnlyAuthentication
  • boolean

Azure Active Directory endast Autentisering aktiverat.

login
  • string

Serveradministratörens inloggningsnamn.

principalType

Huvudtyp för administratören för serverservern.

sid
  • string

SID (objekt-ID) för serveradministratören.

tenantId
  • string

Administratörens klientorganisations-ID.

ServerNetworkAccessFlag

Om offentlig slutpunktsåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"

Name Type Description
Disabled
  • string
Enabled
  • string

ServerPrivateEndpointConnection

En privat slutpunktsanslutning under en server

Name Type Description
id
  • string

Resurs-ID.

properties

Egenskaper för privat slutpunktsanslutning

ServerUpdate

En uppdateringsbegäran för en Azure SQL Database-server.

Name Type Description
identity

Serveridentitet

properties.administratorLogin
  • string

Administratörsanvändarnamn för servern. När den har skapats kan den inte ändras.

properties.administratorLoginPassword
  • string

Administratörens inloggningslösenord (krävs för att skapa servern).

properties.administrators

Serverns Azure Active Directory-administratör.

properties.federatedClientId
  • string

Klient-ID:t som används för CMK-scenario mellan klientorganisationer

properties.fullyQualifiedDomainName
  • string

Serverns fullständigt kvalificerade domännamn.

properties.keyId
  • string

En CMK-URI för nyckeln som ska användas för kryptering.

properties.minimalTlsVersion
  • string

Minimal TLS-version. Tillåtna värden: "1.0", "1.1", "1.2"

properties.primaryUserAssignedIdentityId
  • string

Resurs-ID för en användartilldelad identitet som ska användas som standard.

properties.privateEndpointConnections

Lista över privata slutpunktsanslutningar på en server

properties.publicNetworkAccess

Om offentlig slutpunktsåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"

properties.restrictOutboundNetworkAccess

Om du vill begränsa utgående nätverksåtkomst för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara "Aktiverat" eller "Inaktiverat"

properties.state
  • string

Serverns tillstånd.

properties.version
  • string

Serverns version.

properties.workspaceFeature

Om en befintlig server har en arbetsyta skapad eller inte och om den tillåter anslutning från arbetsytan

tags
  • object

Resurstaggar.

ServerWorkspaceFeature

Om en befintlig server har en arbetsyta skapad eller inte och om den tillåter anslutning från arbetsytan

Name Type Description
Connected
  • string
Disconnected
  • string

UserIdentity

Azure Active Directory identitetskonfiguration för en resurs.

Name Type Description
clientId
  • string

Det Azure Active Directory klient-ID:t.

principalId
  • string

Det Azure Active Directory huvudnamns-ID:t.