你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Server Operations - List By Server

服务:: SQL Database

API 版本:: 2023-08-01

获取服务器上执行的作的列表。

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

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	包含资源的资源组的名称。可以从 Azure 资源管理器 API 或门户获取此值。
serverName	path	True	string	服务器的名称。
subscriptionId	path	True	string	标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。

响应

名称	类型	说明
200 OK	ServerOperationListResult	已成功执行获取服务器作的请求。
Other Status Codes	ErrorResponse	错误响应： *** 400 ManagedInstanceStoppingOrStopped - 实例处于停止/停止状态时提交的冲突作 400 ManagedInstanceStarting - 实例处于启动状态时提交的冲突作 400 InvalidServerName - 指定的服务器名称无效。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 400 TokenTooLong - 提供的令牌太长。 400 NameAlreadyExistsSoftDeleted - 请求的服务器名称由处于软删除状态的服务器获取。清除或恢复服务器以取消阻止。 400 MissingIdentityId - 当标识类型设置为 UserAssigned 时，不会提供用户分配的标识 400 InvalidPrimaryIdentityId - 用户为 PrimaryUserIdentityId 提供值，但 IdentityId 参数中未列出相同的值 400 PECsNotExistingToDenyPublicNetworkAccess - 无法将拒绝公用网络访问设置为“是”，因为没有启用专用终结点访问服务器。请设置专用终结点并重试作（https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database）。 400 NameAlreadyExists - 提供的名称已存在。 400 UmiMissingAkvPermissions - 用户提供的 PrimaryUserAssignedIdentityId 无权访问提供的 KeyId 400 MissingPrimaryIdentity - 用户提供的 PrimaryUserAssignedIdentityId 无权访问提供的 KeyId 400 ProvisioningDisabled - 按原样显示资源作授权者的错误消息，无需更改 400 PrimaryIdentityMissingPermissionForKeyId - KeyId 由用户在创建期间提供，但在 API 调用中未提供 PrimaryUserAssignedIdentityId 400 InvalidIdentityTypeForKeyId - KeyId 在创建过程中由用户提供，但标识类型未设置为“UserAssigned” 400 InvalidLoginName - 提供的登录名无效。 400 InvalidUsername - 提供的用户名包含无效字符。 400 Ipv6FeatureNotEnabled - 用户尝试在服务器上启用 Ipv6 支持，而无需在订阅上启用功能标志，或者功能支持当前已在该区域禁用。 400 PasswordTooShort - 提供的密码太短 400 AadOnlyAuthenticationIsEnabled - 已启用 Azure Active Directory 仅身份验证。请与系统管理员联系。 400 RegionDoesNotSupportVersion - 用户尝试在不支持该服务器版本的位置创建指定版本的服务器。 400 PasswordTooLong - 提供的密码太长。 400 PasswordNotComplex - 提供的密码不够复杂。 400 InvalidParameterValue - 为参数提供无效值。 400 InvalidLocation - 指定了无效位置。 400 InvalidServerName - 指定的服务器名称无效。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 400 TokenTooLong - 提供的令牌太长。 400 CMKOperationNotAllowed - 当服务器没有 Azure Key Vault 访问时，用户尝试在服务器上执行作。 400 ServerNotFound - 找不到请求的服务器。 400 RegionDoesNotAllowProvisioning - 所选位置不接受新的 Windows Azure SQL 数据库服务器。这可能会在以后更改。 400 CannotDropDatabaseAKVError - 无法安全地删除服务器 {0} 上的数据库 {1}，因为它使用客户管理的密钥进行加密，该密钥在删除之前无法再进行上次备份。请在服务器上还原 Azure Key Vault 访问，并重新验证密钥以使此数据库可访问，然后继续删除。有关详细信息，请参阅 https://aka.ms/tdecmkrestorability 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 OperationIdNotFound - ID作不存在。 404 OperationIdNotFound - ID作不存在。 404 SubscriptionNotFound - 找不到请求的订阅。 404 SubscriptionNotFound - 找不到请求的订阅。 409 CannotCancelOperation - 管理作处于无法取消的状态。 409 OperationCancelled -作已被用户取消。 409 OperationInterrupted - 无法完成资源上的作，因为它被同一资源上的另一个作中断。 409 UpsertLogicalServerRequestAlreadyInProgress - 正在进行的逻辑服务器请求正在进行中，请稍后再次尝试你的请求。 409 ServerDisabled - 服务器已禁用。 409 ConflictingServerOperation - 服务器当前正在进行作。 409 SubscriptionDisabled - 已禁用订阅。 409 ServerQuotaExceeded - 无法将服务器添加到订阅，因为它将超过配额。 409 ServerAlreadyExists - 重复服务器名称。 409 ServerDisabled - 服务器已禁用。 409 DropLogicalServerAlreadyInProgress - 服务器已被删除。 409 ConflictingServerOperation - 服务器当前正在进行作。 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。 429 ConflictingSubscriptionOperation - 订阅当前正在进行作。 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。 500 OperationTimedOut -作超时并自动回滚。请重试该作。 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。

名称

类型

说明

200 OK

ServerOperationListResult

已成功执行获取服务器作的请求。

Other Status Codes

ErrorResponse

错误响应： ***

400 ManagedInstanceStoppingOrStopped - 实例处于停止/停止状态时提交的冲突作
400 ManagedInstanceStarting - 实例处于启动状态时提交的冲突作
400 InvalidServerName - 指定的服务器名称无效。
400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。
400 TokenTooLong - 提供的令牌太长。
400 NameAlreadyExistsSoftDeleted - 请求的服务器名称由处于软删除状态的服务器获取。清除或恢复服务器以取消阻止。
400 MissingIdentityId - 当标识类型设置为 UserAssigned 时，不会提供用户分配的标识
400 InvalidPrimaryIdentityId - 用户为 PrimaryUserIdentityId 提供值，但 IdentityId 参数中未列出相同的值
400 PECsNotExistingToDenyPublicNetworkAccess - 无法将拒绝公用网络访问设置为“是”，因为没有启用专用终结点访问服务器。请设置专用终结点并重试作（https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database）。
400 NameAlreadyExists - 提供的名称已存在。
400 UmiMissingAkvPermissions - 用户提供的 PrimaryUserAssignedIdentityId 无权访问提供的 KeyId
400 MissingPrimaryIdentity - 用户提供的 PrimaryUserAssignedIdentityId 无权访问提供的 KeyId
400 ProvisioningDisabled - 按原样显示资源作授权者的错误消息，无需更改
400 PrimaryIdentityMissingPermissionForKeyId - KeyId 由用户在创建期间提供，但在 API 调用中未提供 PrimaryUserAssignedIdentityId
400 InvalidIdentityTypeForKeyId - KeyId 在创建过程中由用户提供，但标识类型未设置为“UserAssigned”
400 InvalidLoginName - 提供的登录名无效。
400 InvalidUsername - 提供的用户名包含无效字符。
400 Ipv6FeatureNotEnabled - 用户尝试在服务器上启用 Ipv6 支持，而无需在订阅上启用功能标志，或者功能支持当前已在该区域禁用。
400 PasswordTooShort - 提供的密码太短
400 AadOnlyAuthenticationIsEnabled - 已启用 Azure Active Directory 仅身份验证。请与系统管理员联系。
400 RegionDoesNotSupportVersion - 用户尝试在不支持该服务器版本的位置创建指定版本的服务器。
400 PasswordTooLong - 提供的密码太长。
400 PasswordNotComplex - 提供的密码不够复杂。
400 InvalidParameterValue - 为参数提供无效值。
400 InvalidLocation - 指定了无效位置。
400 InvalidServerName - 指定的服务器名称无效。
400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。
400 TokenTooLong - 提供的令牌太长。
400 CMKOperationNotAllowed - 当服务器没有 Azure Key Vault 访问时，用户尝试在服务器上执行作。
400 ServerNotFound - 找不到请求的服务器。
400 RegionDoesNotAllowProvisioning - 所选位置不接受新的 Windows Azure SQL 数据库服务器。这可能会在以后更改。
400 CannotDropDatabaseAKVError - 无法安全地删除服务器 {0} 上的数据库 {1}，因为它使用客户管理的密钥进行加密，该密钥在删除之前无法再进行上次备份。请在服务器上还原 Azure Key Vault 访问，并重新验证密钥以使此数据库可访问，然后继续删除。有关详细信息，请参阅 https://aka.ms/tdecmkrestorability
404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。
404 SubscriptionDoesNotHaveServer - 找不到请求的服务器
404 OperationIdNotFound - ID作不存在。
404 OperationIdNotFound - ID作不存在。
404 SubscriptionNotFound - 找不到请求的订阅。
404 SubscriptionNotFound - 找不到请求的订阅。
409 CannotCancelOperation - 管理作处于无法取消的状态。
409 OperationCancelled -作已被用户取消。
409 OperationInterrupted - 无法完成资源上的作，因为它被同一资源上的另一个作中断。
409 UpsertLogicalServerRequestAlreadyInProgress - 正在进行的逻辑服务器请求正在进行中，请稍后再次尝试你的请求。
409 ServerDisabled - 服务器已禁用。
409 ConflictingServerOperation - 服务器当前正在进行作。
409 SubscriptionDisabled - 已禁用订阅。
409 ServerQuotaExceeded - 无法将服务器添加到订阅，因为它将超过配额。
409 ServerAlreadyExists - 重复服务器名称。
409 ServerDisabled - 服务器已禁用。
409 DropLogicalServerAlreadyInProgress - 服务器已被删除。
409 ConflictingServerOperation - 服务器当前正在进行作。
429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。
429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。
429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。
429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。
429 ConflictingSubscriptionOperation - 订阅当前正在进行作。
429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。
429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。
500 OperationTimedOut -作超时并自动回滚。请重试该作。
503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。
503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。
503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。

示例

List the server management operations

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/operations?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/ListServerOperations.json
// this example is just showing the usage of "ServerOperations_ListByServer" 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://learn.microsoft.com/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 and iterate over the result
await foreach (ServerOperationData item in sqlServer.GetServerOperationsAsync())
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine("Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/operations/11111111-1111-1111-1111-111111111111",
      "name": "11111111-1111-1111-1111-111111111111",
      "type": "Microsoft.Sql/servers/operations",
      "properties": {
        "operation": "MakeAllLogicalDatabasesAccessible",
        "operationFriendlyName": "MAKE ALL DBS ACCESSIBLE",
        "percentComplete": 0,
        "serverName": "sqlcrudtest-4645",
        "startTime": "2017-06-01T09:10:08.1Z",
        "state": "InProgress"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/operations/22222222-2222-2222-2222-222222222222",
      "name": "22222222-2222-2222-2222-222222222222",
      "type": "Microsoft.Sql/servers/operations",
      "properties": {
        "operation": "MakeAllLogicalDatabasesAccessible",
        "operationFriendlyName": "MAKE ALL DBS ACCESSIBLE",
        "percentComplete": 100,
        "serverName": "sqlcrudtest-4645",
        "startTime": "2017-06-01T09:00:08.1Z",
        "state": "Succeeded"
      }
    }
  ]
}

定义

名称	说明
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ManagementOperationState	作状态。
ServerOperation	服务器作。
ServerOperationListResult	对列表服务器作请求的响应

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ManagementOperationState

枚举

作状态。

值	说明
Pending
InProgress
Succeeded
Failed
CancelInProgress
Cancelled

ServerOperation

Object

服务器作。

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.description	string	作说明。
properties.errorCode	integer (int32)	作错误代码。
properties.errorDescription	string	作错误说明。
properties.errorSeverity	integer (int32)	作错误严重性。
properties.estimatedCompletionTime	string (date-time)	作的估计完成时间。
properties.isCancellable	boolean	是否可以取消作。
properties.isUserError	boolean	错误是否为用户错误。
properties.operation	string	作的名称。
properties.operationFriendlyName	string	作的友好名称。
properties.percentComplete	integer (int32)	已完成作的百分比。
properties.serverName	string	服务器的名称。
properties.startTime	string (date-time)	作开始时间。
properties.state	ManagementOperationState	作状态。
type	string	资源类型。

ServerOperationListResult

Object

对列表服务器作请求的响应

名称	类型	说明
nextLink	string	用于检索下一页结果的链接。
value	ServerOperation[]	结果数组。

通过

Server Operations - List By Server

URI 参数

响应

示例

List the server management operations

示例请求

示例响应

定义

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagementOperationState

ServerOperation

ServerOperationListResult