Servers - Create Or Update
Kiszolgálót hoz létre vagy frissít.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2023-08-01
URI-paraméterek
| Name | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be. |
|
server
|
path | True |
string |
A kiszolgáló neve. |
|
subscription
|
path | True |
string |
Az Azure-előfizetést azonosító előfizetés-azonosító. |
|
api-version
|
query | True |
string |
A kéréshez használni kívánt API-verzió. |
Kérelem törzse
| Name | Kötelező | Típus | Description |
|---|---|---|---|
| location | True |
string |
Erőforrás helye. |
| identity |
A kiszolgáló Azure Active Directory-identitása. |
||
| properties.administratorLogin |
string |
A kiszolgáló rendszergazdai felhasználóneve. A létrehozás után nem módosítható. |
|
| properties.administratorLoginPassword |
string |
A rendszergazda bejelentkezési jelszava (a kiszolgáló létrehozásához szükséges). |
|
| properties.administrators |
A kiszolgáló Azure Active Directory-rendszergazdája. Ez csak a kiszolgáló létrehozásakor használható. Ha kiszolgálófrissítéshez használják, a rendszer figyelmen kívül hagyja, vagy hibát eredményez. A frissítésekhez egyéni API-kat kell használni. |
||
| properties.federatedClientId |
string (uuid) |
A bérlők közötti CMK-forgatókönyvhöz használt ügyfélazonosító |
|
| properties.isIPv6Enabled |
A kiszolgáló IPv6-támogatásának engedélyezése. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie |
||
| properties.keyId |
string |
A titkosításhoz használandó kulcs CMK URI-ja. |
|
| properties.minimalTlsVersion |
Minimális TLS-verzió. Engedélyezett értékek: "Nincs", 1.0", "1.1", "1.2", "1.3" |
||
| properties.primaryUserAssignedIdentityId |
string |
A felhasználó által hozzárendelt identitás erőforrás-azonosítója, amelyet alapértelmezés szerint használni szeretne. |
|
| properties.publicNetworkAccess |
Azt jelzi, hogy engedélyezett-e nyilvános végpont-hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" vagy "SecuredByPerimeter" értéknek kell lennie. |
||
| properties.restrictOutboundNetworkAccess |
A kiszolgáló kimenő hálózati hozzáférésének korlátozása. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie |
||
| properties.version |
string |
A kiszolgáló verziója. |
|
| tags |
object |
Erőforráscímkék. |
Válaszok
| Name | Típus | Description |
|---|---|---|
| 200 OK |
A kiszolgáló frissítése sikeresen megtörtént. |
|
| 201 Created |
Sikeresen létrehozta a kiszolgálót. |
|
| 202 Accepted |
Elfogadott Fejlécek Location: string |
|
| Other Status Codes |
Hibaválaszok: ***
|
Példák
Create server
Mintakérelem
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"
}
Mintaválasz
{
"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"
}
}
}
]
}
}
Definíciók
| Name | Description |
|---|---|
|
Administrator |
A rendszergazda típusa. |
|
Error |
Az erőforrás-kezelési hiba további információi. |
|
Error |
A hiba részletei. |
|
Error |
Hibaválasz |
|
External |
A külső irányítás állapota. |
|
Identity |
Az identitás típusa. Állítsa ezt a "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz. |
|
Minimal |
Minimális TLS-verzió. Engedélyezett értékek: "Nincs", 1.0", "1.1", "1.2", "1.3" |
|
Principal |
A rendszergazda egyszerű típusa. |
|
Private |
Privát végpontkapcsolat tulajdonságai. |
|
Private |
|
|
Private |
A privát végpontkapcsolat állapota. |
|
Private |
A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek. |
|
Private |
|
|
Private |
A privát kapcsolat szolgáltatás kapcsolati állapota. |
|
Resource |
Azure Active Directory-identitáskonfiguráció egy erőforráshoz. |
| Server |
Egy Azure SQL Database-kiszolgáló. |
|
Server |
Az Active Directory-rendszergazda tulajdonságai. |
|
Server |
A kiszolgáló kimenő hálózati hozzáférésének korlátozása. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie |
|
Server |
Privát végpontkapcsolat egy kiszolgáló alatt |
|
Server |
Azt jelzi, hogy engedélyezett-e nyilvános végpont-hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" vagy "SecuredByPerimeter" értéknek kell lennie. |
|
Server |
Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e munkaterület létrehozásával, és engedélyezi-e a kapcsolatot a munkaterületről |
|
User |
Azure Active Directory-identitáskonfiguráció egy erőforráshoz. |
AdministratorType
A rendszergazda típusa.
| Érték | Description |
|---|---|
| ActiveDirectory |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
| Name | Típus | Description |
|---|---|---|
| info |
object |
A további információk. |
| type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
| Name | Típus | Description |
|---|---|---|
| additionalInfo |
A hiba további információi. |
|
| code |
string |
A hibakód. |
| details |
A hiba részletei. |
|
| message |
string |
A hibaüzenet. |
| target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
| Name | Típus | Description |
|---|---|---|
| error |
A hibaobjektum. |
ExternalGovernanceStatus
A külső irányítás állapota.
| Érték | Description |
|---|---|
| Enabled | |
| Disabled |
IdentityType
Az identitás típusa. Állítsa ezt a "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.
| Érték | Description |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
MinimalTlsVersion
Minimális TLS-verzió. Engedélyezett értékek: "Nincs", 1.0", "1.1", "1.2", "1.3"
| Érték | Description |
|---|---|
| None | |
| 1.0 | |
| 1.1 | |
| 1.2 | |
| 1.3 |
PrincipalType
A rendszergazda egyszerű típusa.
| Érték | Description |
|---|---|
| User | |
| Group | |
| Application |
PrivateEndpointConnectionProperties
Privát végpontkapcsolat tulajdonságai.
| Name | Típus | Description |
|---|---|---|
| groupIds |
string[] |
Csoportazonosítók. |
| privateEndpoint |
Privát végpont, amelyhez a kapcsolat tartozik. |
|
| privateLinkServiceConnectionState |
A privát végpont kapcsolati állapota. |
|
| provisioningState |
A privát végpontkapcsolat állapota. |
PrivateEndpointProperty
| Name | Típus | Description |
|---|---|---|
| id |
string |
A privát végpont erőforrás-azonosítója. |
PrivateEndpointProvisioningState
A privát végpontkapcsolat állapota.
| Érték | Description |
|---|---|
| Approving | |
| Ready | |
| Dropping | |
| Failed | |
| Rejecting |
PrivateLinkServiceConnectionStateActionsRequire
A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek.
| Érték | Description |
|---|---|
| None |
PrivateLinkServiceConnectionStateProperty
| Name | Típus | Description |
|---|---|---|
| actionsRequired |
A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek. |
|
| description |
string |
A privát kapcsolat szolgáltatás kapcsolatának leírása. |
| status |
A privát kapcsolat szolgáltatás kapcsolati állapota. |
PrivateLinkServiceConnectionStateStatus
A privát kapcsolat szolgáltatás kapcsolati állapota.
| Érték | Description |
|---|---|
| Approved | |
| Pending | |
| Rejected | |
| Disconnected |
ResourceIdentity
Azure Active Directory-identitáskonfiguráció egy erőforráshoz.
| Name | Típus | Description |
|---|---|---|
| principalId |
string (uuid) |
Az Azure Active Directory egyszerű azonosítója. |
| tenantId |
string (uuid) |
Az Azure Active Directory bérlőazonosítója. |
| type |
Az identitás típusa. Állítsa ezt a "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz. |
|
| userAssignedIdentities |
<string,
User |
A felhasználó által hozzárendelt használt identitások erőforrás-azonosítói |
Server
Egy Azure SQL Database-kiszolgáló.
| Name | Típus | Description |
|---|---|---|
| id |
string |
Erőforrás-azonosító. |
| identity |
A kiszolgáló Azure Active Directory-identitása. |
|
| kind |
string |
Az SQL Server típusa. Ez az Azure Portal felhasználói élményéhez használt metaadatok. |
| location |
string |
Erőforrás helye. |
| name |
string |
Erőforrás neve. |
| properties.administratorLogin |
string |
A kiszolgáló rendszergazdai felhasználóneve. A létrehozás után nem módosítható. |
| properties.administratorLoginPassword |
string |
A rendszergazda bejelentkezési jelszava (a kiszolgáló létrehozásához szükséges). |
| properties.administrators |
A kiszolgáló Azure Active Directory-rendszergazdája. Ez csak a kiszolgáló létrehozásakor használható. Ha kiszolgálófrissítéshez használják, a rendszer figyelmen kívül hagyja, vagy hibát eredményez. A frissítésekhez egyéni API-kat kell használni. |
|
| properties.externalGovernanceStatus |
A külső irányítás állapota. |
|
| properties.federatedClientId |
string (uuid) |
A bérlők közötti CMK-forgatókönyvhöz használt ügyfélazonosító |
| properties.fullyQualifiedDomainName |
string |
A kiszolgáló teljes tartományneve. |
| properties.isIPv6Enabled |
A kiszolgáló IPv6-támogatásának engedélyezése. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie |
|
| properties.keyId |
string |
A titkosításhoz használandó kulcs CMK URI-ja. |
| properties.minimalTlsVersion |
Minimális TLS-verzió. Engedélyezett értékek: "Nincs", 1.0", "1.1", "1.2", "1.3" |
|
| properties.primaryUserAssignedIdentityId |
string |
A felhasználó által hozzárendelt identitás erőforrás-azonosítója, amelyet alapértelmezés szerint használni szeretne. |
| properties.privateEndpointConnections |
A kiszolgáló magánvégpont-kapcsolatainak listája |
|
| properties.publicNetworkAccess |
Azt jelzi, hogy engedélyezett-e nyilvános végpont-hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" vagy "SecuredByPerimeter" értéknek kell lennie. |
|
| properties.restrictOutboundNetworkAccess |
A kiszolgáló kimenő hálózati hozzáférésének korlátozása. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie |
|
| properties.state |
string |
A kiszolgáló állapota. |
| properties.version |
string |
A kiszolgáló verziója. |
| properties.workspaceFeature |
Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e munkaterület létrehozásával, és engedélyezi-e a kapcsolatot a munkaterületről |
|
| tags |
object |
Erőforráscímkék. |
| type |
string |
Erőforrás típusa. |
ServerExternalAdministrator
Az Active Directory-rendszergazda tulajdonságai.
| Name | Típus | Description |
|---|---|---|
| administratorType |
A rendszergazda típusa. |
|
| azureADOnlyAuthentication |
boolean |
Csak az Azure Active Directory hitelesítése engedélyezett. |
| login |
string |
A kiszolgáló rendszergazdájának bejelentkezési neve. |
| principalType |
A rendszergazda egyszerű típusa. |
|
| sid |
string (uuid) |
A kiszolgáló rendszergazdájának SID-azonosítója (objektumazonosítója). |
| tenantId |
string (uuid) |
A rendszergazda bérlőazonosítója. |
ServerNetworkAccessFlag
A kiszolgáló kimenő hálózati hozzáférésének korlátozása. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie
| Érték | Description |
|---|---|
| Enabled | |
| Disabled |
ServerPrivateEndpointConnection
Privát végpontkapcsolat egy kiszolgáló alatt
| Name | Típus | Description |
|---|---|---|
| id |
string |
Erőforrás-azonosító. |
| properties |
Privát végpont kapcsolati tulajdonságai |
ServerPublicNetworkAccessFlag
Azt jelzi, hogy engedélyezett-e nyilvános végpont-hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" vagy "SecuredByPerimeter" értéknek kell lennie.
| Érték | Description |
|---|---|
| Enabled | |
| Disabled | |
| SecuredByPerimeter |
ServerWorkspaceFeature
Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e munkaterület létrehozásával, és engedélyezi-e a kapcsolatot a munkaterületről
| Érték | Description |
|---|---|
| Connected | |
| Disconnected |
UserIdentity
Azure Active Directory-identitáskonfiguráció egy erőforráshoz.
| Name | Típus | Description |
|---|---|---|
| clientId |
string (uuid) |
Az Azure Active Directory-ügyfél azonosítója. |
| principalId |
string (uuid) |
Az Azure Active Directory egyszerű azonosítója. |