Servers - Create Or Update
Hiermee maakt of werkt u een server bij.
PUT 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 |
---|---|---|---|---|
resource
|
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. |
server
|
path | True |
string |
De naam van de server. |
subscription
|
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 | Vereist | Type | Description |
---|---|---|---|
location | True |
string |
Resourcelocatie. |
identity |
De Azure Active Directory-identiteit van de server. |
||
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 |
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 |
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 |
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 |
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 |
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 |
De server is bijgewerkt. |
|
201 Created |
De server is gemaakt. |
|
202 Accepted |
Geaccepteerd Kopteksten Location: string |
|
Other Status Codes |
Foutreacties: ***
|
Voorbeelden
Create server
Voorbeeldaanvraag
PUT 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",
"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",
"isIPv6Enabled": "Enabled"
},
"location": "Japan East"
}
Voorbeeldrespons
{
"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",
"isIPv6Enabled": "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"
}
}
}
]
}
}
{
"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",
"isIPv6Enabled": "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"
}
}
}
]
}
}
Definities
Name | Description |
---|---|
Administrator |
Type van de serverbeheerder. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
External |
Status van extern beheer. |
Identity |
Het identiteitstype. Stel dit in op SystemAssigned om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen. |
Minimal |
Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3' |
Principal |
Principal-type van de serverbeheerder. |
Private |
Eigenschappen van een privé-eindpuntverbinding. |
Private |
|
Private |
Status van de privé-eindpuntverbinding. |
Private |
De acties die nodig zijn voor de private link-serviceverbinding. |
Private |
|
Private |
De verbindingsstatus van de Private Link-service. |
Resource |
Azure Active Directory-identiteitsconfiguratie voor een resource. |
Server |
Een Azure SQL Database-server. |
Server |
Eigenschappen van een Active Directory-beheerder. |
Server |
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 |
Server |
Een privé-eindpuntverbinding onder een server |
Server |
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 |
Server |
Of er al dan niet een bestaande server een werkruimte is gemaakt en of er verbinding vanuit de werkruimte is toegestaan |
User |
Azure Active Directory-identiteitsconfiguratie voor een resource. |
AdministratorType
Type van de serverbeheerder.
Waarde | Description |
---|---|
ActiveDirectory |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
Name | Type | Description |
---|---|---|
info |
object |
De aanvullende informatie. |
type |
string |
Het extra informatietype. |
ErrorDetail
De foutdetails.
Name | Type | Description |
---|---|---|
additionalInfo |
De fout bevat aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
Het foutobject. |
ExternalGovernanceStatus
Status van extern beheer.
Waarde | Description |
---|---|
Disabled | |
Enabled |
IdentityType
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 | |
SystemAssigned,UserAssigned | |
UserAssigned |
MinimalTlsVersion
Minimale TLS-versie. Toegestane waarden: 'None', 1.0', '1.1', '1.2', '1.3'
Waarde | Description |
---|---|
1.0 | |
1.1 | |
1.2 | |
1.3 | |
None |
PrincipalType
Principal-type van de serverbeheerder.
Waarde | Description |
---|---|
Application | |
Group | |
User |
PrivateEndpointConnectionProperties
Eigenschappen van een privé-eindpuntverbinding.
Name | Type | Description |
---|---|---|
groupIds |
string[] |
Groeps-id's. |
privateEndpoint |
Privé-eindpunt waartoe de verbinding behoort. |
|
privateLinkServiceConnectionState |
Verbindingsstatus van de privé-eindpuntverbinding. |
|
provisioningState |
Status van de privé-eindpuntverbinding. |
PrivateEndpointProperty
Name | Type | Description |
---|---|---|
id |
string |
Resource-id van het privé-eindpunt. |
PrivateEndpointProvisioningState
Status van de privé-eindpuntverbinding.
Waarde | Description |
---|---|
Approving | |
Dropping | |
Failed | |
Ready | |
Rejecting |
PrivateLinkServiceConnectionStateActionsRequire
De acties die nodig zijn voor de private link-serviceverbinding.
Waarde | Description |
---|---|
None |
PrivateLinkServiceConnectionStateProperty
Name | Type | Description |
---|---|---|
actionsRequired |
De acties die nodig zijn voor de private link-serviceverbinding. |
|
description |
string |
De beschrijving van de private link-serviceverbinding. |
status |
De verbindingsstatus van de Private Link-service. |
PrivateLinkServiceConnectionStateStatus
De verbindingsstatus van de Private Link-service.
Waarde | Description |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected |
ResourceIdentity
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 |
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,
User |
De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt |
Server
Een Azure SQL Database-server.
Name | Type | Description |
---|---|---|
id |
string |
Resource-id. |
identity |
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 |
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 |
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 |
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 |
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 |
Lijst met privé-eindpuntverbindingen op een server |
|
properties.publicNetworkAccess |
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 |
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 |
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
Eigenschappen van een Active Directory-beheerder.
Name | Type | Description |
---|---|---|
administratorType |
Type van de serverbeheerder. |
|
azureADOnlyAuthentication |
boolean |
Alleen azure Active Directory-verificatie ingeschakeld. |
login |
string |
Aanmeldingsnaam van de serverbeheerder. |
principalType |
Principal-type van de serverbeheerder. |
|
sid |
string (uuid) |
SID (object-id) van de serverbeheerder. |
tenantId |
string (uuid) |
Tenant-id van de 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
Waarde | Description |
---|---|
Disabled | |
Enabled |
ServerPrivateEndpointConnection
Een privé-eindpuntverbinding onder een server
Name | Type | Description |
---|---|---|
id |
string |
Resource-id. |
properties |
Eigenschappen van privé-eindpuntverbinding |
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
Waarde | Description |
---|---|
Disabled | |
Enabled | |
SecuredByPerimeter |
ServerWorkspaceFeature
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
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. |