Servers - Create Or Update
Vytvoří nebo aktualizuje server.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2023-08-01
Parametry identifikátoru URI
| Name | V | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu. |
|
server
|
path | True |
string |
Název serveru. |
|
subscription
|
path | True |
string |
ID předplatného, které identifikuje předplatné Azure. |
|
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro požadavek. |
Text požadavku
| Name | Vyžadováno | Typ | Description |
|---|---|---|---|
| location | True |
string |
Umístění prostředku |
| identity |
Identita azure Active Directory serveru. |
||
| properties.administratorLogin |
string |
Uživatelské jméno správce pro server. Po vytvoření se nedá změnit. |
|
| properties.administratorLoginPassword |
string |
Přihlašovací heslo správce (vyžaduje se k vytvoření serveru). |
|
| properties.administrators |
Správce azure Active Directory serveru. Tuto možnost lze použít pouze v době vytvoření serveru. Pokud se používá pro aktualizaci serveru, bude ignorován nebo dojde k chybě. Pro aktualizace bude potřeba použít jednotlivá rozhraní API. |
||
| properties.federatedClientId |
string (uuid) |
ID klienta používaného pro scénář cmk napříč tenanty |
|
| properties.isIPv6Enabled |
Jestli chcete povolit podporu protokolu IPv6 pro tento server, nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno). |
||
| properties.keyId |
string |
Identifikátor URI klíče CMK, který se má použít k šifrování. |
|
| properties.minimalTlsVersion |
Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2, 1.2, 1.3 |
||
| properties.primaryUserAssignedIdentityId |
string |
ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení. |
|
| properties.publicNetworkAccess |
Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno) nebo SecuredByPerimeter (SecuredByPerimeter). |
||
| properties.restrictOutboundNetworkAccess |
Určuje, jestli chcete omezit odchozí síťový přístup pro tento server. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno). |
||
| properties.version |
string |
Verze serveru. |
|
| tags |
object |
Značky prostředků |
Odpovědi
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Server se úspěšně aktualizoval. |
|
| 201 Created |
Server se úspěšně vytvořil. |
|
| 202 Accepted |
Přijal Hlavičky Location: string |
|
| Other Status Codes |
Chybové odpovědi: ***
|
Příklady
Create server
Ukázkový požadavek
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"
}
Ukázková odpověď
{
"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"
}
}
}
]
}
}
Definice
| Name | Description |
|---|---|
|
Administrator |
Typ správce serveru. |
|
Error |
Další informace o chybě správy prostředků |
|
Error |
Podrobnosti o chybě. |
|
Error |
Chybová odpověď |
|
External |
Stav externích zásad správného řízení |
|
Identity |
Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek. |
|
Minimal |
Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2, 1.2, 1.3 |
|
Principal |
Hlavní typ správce serveru. |
|
Private |
Vlastnosti připojení privátního koncového bodu |
|
Private |
|
|
Private |
Stav připojení privátního koncového bodu |
|
Private |
Akce vyžadované pro připojení služby Private Link |
|
Private |
|
|
Private |
Stav připojení služby Private Link. |
|
Resource |
Konfigurace identity Azure Active Directory pro prostředek |
| Server |
Server Azure SQL Database. |
|
Server |
Vlastnosti správce služby Active Directory |
|
Server |
Určuje, jestli chcete omezit odchozí síťový přístup pro tento server. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno). |
|
Server |
Připojení privátního koncového bodu pod serverem |
|
Server |
Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno) nebo SecuredByPerimeter (SecuredByPerimeter). |
|
Server |
Určuje, jestli má existující server vytvořený pracovní prostor a jestli umožňuje připojení z pracovního prostoru. |
|
User |
Konfigurace identity Azure Active Directory pro prostředek |
AdministratorType
Typ správce serveru.
| Hodnota | Description |
|---|---|
| ActiveDirectory |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
| Name | Typ | Description |
|---|---|---|
| info |
object |
Další informace. |
| type |
string |
Další typ informací. |
ErrorDetail
Podrobnosti o chybě.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Další informace o chybě. |
|
| code |
string |
Kód chyby. |
| details |
Podrobnosti o chybě. |
|
| message |
string |
Chybová zpráva. |
| target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
| Name | Typ | Description |
|---|---|---|
| error |
Objekt chyby. |
ExternalGovernanceStatus
Stav externích zásad správného řízení
| Hodnota | Description |
|---|---|
| Enabled | |
| Disabled |
IdentityType
Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek.
| Hodnota | Description |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
MinimalTlsVersion
Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2, 1.2, 1.3
| Hodnota | Description |
|---|---|
| None | |
| 1.0 | |
| 1.1 | |
| 1.2 | |
| 1.3 |
PrincipalType
Hlavní typ správce serveru.
| Hodnota | Description |
|---|---|
| User | |
| Group | |
| Application |
PrivateEndpointConnectionProperties
Vlastnosti připojení privátního koncového bodu
| Name | Typ | Description |
|---|---|---|
| groupIds |
string[] |
ID skupin |
| privateEndpoint |
Privátní koncový bod, ke kterému připojení patří. |
|
| privateLinkServiceConnectionState |
Stav připojení privátního koncového bodu |
|
| provisioningState |
Stav připojení privátního koncového bodu |
PrivateEndpointProperty
| Name | Typ | Description |
|---|---|---|
| id |
string |
ID prostředku privátního koncového bodu |
PrivateEndpointProvisioningState
Stav připojení privátního koncového bodu
| Hodnota | Description |
|---|---|
| Approving | |
| Ready | |
| Dropping | |
| Failed | |
| Rejecting |
PrivateLinkServiceConnectionStateActionsRequire
Akce vyžadované pro připojení služby Private Link
| Hodnota | Description |
|---|---|
| None |
PrivateLinkServiceConnectionStateProperty
| Name | Typ | Description |
|---|---|---|
| actionsRequired |
Akce vyžadované pro připojení služby Private Link |
|
| description |
string |
Popis připojení služby Private Link. |
| status |
Stav připojení služby Private Link. |
PrivateLinkServiceConnectionStateStatus
Stav připojení služby Private Link.
| Hodnota | Description |
|---|---|
| Approved | |
| Pending | |
| Rejected | |
| Disconnected |
ResourceIdentity
Konfigurace identity Azure Active Directory pro prostředek
| Name | Typ | Description |
|---|---|---|
| principalId |
string (uuid) |
ID objektu zabezpečení Azure Active Directory. |
| tenantId |
string (uuid) |
ID tenanta Azure Active Directory. |
| type |
Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek. |
|
| userAssignedIdentities |
<string,
User |
ID prostředků identit přiřazených uživatelem, které se mají použít |
Server
Server Azure SQL Database.
| Name | Typ | Description |
|---|---|---|
| id |
string |
ID prostředku. |
| identity |
Identita azure Active Directory serveru. |
|
| kind |
string |
Druh sql serveru. Toto jsou metadata používaná pro prostředí webu Azure Portal. |
| location |
string |
Umístění prostředku |
| name |
string |
Název prostředku |
| properties.administratorLogin |
string |
Uživatelské jméno správce pro server. Po vytvoření se nedá změnit. |
| properties.administratorLoginPassword |
string |
Přihlašovací heslo správce (vyžaduje se k vytvoření serveru). |
| properties.administrators |
Správce azure Active Directory serveru. Tuto možnost lze použít pouze v době vytvoření serveru. Pokud se používá pro aktualizaci serveru, bude ignorován nebo dojde k chybě. Pro aktualizace bude potřeba použít jednotlivá rozhraní API. |
|
| properties.externalGovernanceStatus |
Stav externích zásad správného řízení |
|
| properties.federatedClientId |
string (uuid) |
ID klienta používaného pro scénář cmk napříč tenanty |
| properties.fullyQualifiedDomainName |
string |
Plně kvalifikovaný název domény serveru. |
| properties.isIPv6Enabled |
Jestli chcete povolit podporu protokolu IPv6 pro tento server, nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno). |
|
| properties.keyId |
string |
Identifikátor URI klíče CMK, který se má použít k šifrování. |
| properties.minimalTlsVersion |
Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2, 1.2, 1.3 |
|
| properties.primaryUserAssignedIdentityId |
string |
ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení. |
| properties.privateEndpointConnections |
Seznam připojení privátních koncových bodů na serveru |
|
| properties.publicNetworkAccess |
Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno) nebo SecuredByPerimeter (SecuredByPerimeter). |
|
| properties.restrictOutboundNetworkAccess |
Určuje, jestli chcete omezit odchozí síťový přístup pro tento server. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno). |
|
| properties.state |
string |
Stav serveru. |
| properties.version |
string |
Verze serveru. |
| properties.workspaceFeature |
Určuje, jestli má existující server vytvořený pracovní prostor a jestli umožňuje připojení z pracovního prostoru. |
|
| tags |
object |
Značky prostředků |
| type |
string |
Typ prostředku. |
ServerExternalAdministrator
Vlastnosti správce služby Active Directory
| Name | Typ | Description |
|---|---|---|
| administratorType |
Typ správce serveru. |
|
| azureADOnlyAuthentication |
boolean |
Je povoleno pouze ověřování Azure Active Directory. |
| login |
string |
Přihlašovací jméno správce serveru. |
| principalType |
Hlavní typ správce serveru. |
|
| sid |
string (uuid) |
IDENTIFIKÁTOR SID (ID objektu) správce serveru. |
| tenantId |
string (uuid) |
ID tenanta správce. |
ServerNetworkAccessFlag
Určuje, jestli chcete omezit odchozí síťový přístup pro tento server. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).
| Hodnota | Description |
|---|---|
| Enabled | |
| Disabled |
ServerPrivateEndpointConnection
Připojení privátního koncového bodu pod serverem
| Name | Typ | Description |
|---|---|---|
| id |
string |
ID prostředku. |
| properties |
Vlastnosti připojení privátního koncového bodu |
ServerPublicNetworkAccessFlag
Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno) nebo SecuredByPerimeter (SecuredByPerimeter).
| Hodnota | Description |
|---|---|
| Enabled | |
| Disabled | |
| SecuredByPerimeter |
ServerWorkspaceFeature
Určuje, jestli má existující server vytvořený pracovní prostor a jestli umožňuje připojení z pracovního prostoru.
| Hodnota | Description |
|---|---|
| Connected | |
| Disconnected |
UserIdentity
Konfigurace identity Azure Active Directory pro prostředek
| Name | Typ | Description |
|---|---|---|
| clientId |
string (uuid) |
ID klienta Azure Active Directory. |
| principalId |
string (uuid) |
ID objektu zabezpečení Azure Active Directory. |