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

Server Trust Groups - Create Or Update

参考

Service:: SQL Database

API Version:: 2021-11-01

创建或更新服务器信任组。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/serverTrustGroups/{serverTrustGroupName}?api-version=2021-11-01

URI 参数

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

请求正文

名称	必需	类型	说明
properties.groupMembers	True	ServerInfo[]	服务器信任组的组成员信息。
properties.trustScopes	True	TrustScopes[]	服务器信任组的信任范围。

响应

名称	类型	说明
200 OK	ServerTrustGroup	已成功更新服务器信任组。
201 Created	ServerTrustGroup	已成功创建服务器信任组。
202 Accepted		已接受
Other Status Codes		错误响应： *** 400 ServerTrustGroupCreateRequestInvalid - 请求正文中的资源或资源属性为空或无效 400 ServerTrustGroupCreateRequestInvalidGroupMembers - 请求正文中的组成员属性为空或无效 400 ServerTrustGroupCreateRequestInvalidGroupMembersCount - 组成员属性的服务器数无效 400 ServerTrustGroupCreateRequestInvalidServer - 创建服务器信任组请求正文中的给定 serverId 字段为空或无效 400 ServerTrustGroupCreateRequestDuplicateServer - 提供的一个或多个服务器是重复服务器。 400 ServerTrustGroupCreateRequestInvalidTrustScopes - 请求正文中的信任范围属性为空或无效。 400 ServerTrustGroupCreateRequestInvalidTrustScopesValue - 请求正文中的信任范围属性具有无效值。 400 ServerTrustGroupCreateRequestInvalidGroupMembersCount2 - 组成员属性的服务器数无效 404 ServerTrustGroupNotFound - 不存在具有指定名称的服务器信任组。 404 OperationIdNotFound - ID 为的操作不存在。 404 ResourceNotFound - 找不到请求的资源。 404 OperationIdNotFound - ID 为的操作不存在。 406 ServerTrustGroupMemberIsBusy - 组成员“”{0}处于无效状态，无法执行服务器信任组操作。 406 ServerTrustGroupInInvalidState - SQL 信任组“”{0}正忙，无法执行请求的操作。 406 ServerTrustGroupMemberNotFound - 找不到组成员“”{0}，因此无法执行服务器信任组操作。 409 OperationCancelled - 用户已取消该操作。 409 操作中断 - 无法完成对资源的操作，因为它被同一资源上的另一个操作中断。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。 429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。 500 OperationTimedOut - 操作超时并自动回滚。请重试该操作。 503 TooManyRequests - 超出可用资源可处理的最大请求数的请求数。

示例

Create server trust group

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/serverTrustGroups/server-trust-group-test?api-version=2021-11-01

{
  "properties": {
    "groupMembers": [
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-1"
      },
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-2"
      }
    ],
    "trustScopes": [
      "GlobalTransactions",
      "ServiceBroker"
    ]
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ServerTrustGroupInner;
import com.azure.resourcemanager.sql.models.ServerInfo;
import com.azure.resourcemanager.sql.models.ServerTrustGroupPropertiesTrustScopesItem;
import java.util.Arrays;

/** Samples for ServerTrustGroups CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerTrustGroupCreate.json
     */
    /**
     * Sample code: Create server trust group.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServerTrustGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerTrustGroups().createOrUpdate("Default", "Japan East",
            "server-trust-group-test",
            new ServerTrustGroupInner().withGroupMembers(Arrays.asList(new ServerInfo().withServerId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-1"),
                new ServerInfo().withServerId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-2")))
                .withTrustScopes(Arrays.asList(ServerTrustGroupPropertiesTrustScopesItem.GLOBAL_TRANSACTIONS,
                    ServerTrustGroupPropertiesTrustScopesItem.SERVICE_BROKER)),
            Context.NONE);
    }
}

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

Sample Response

Status code:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/serverTrustGroups/server-trust-group-test",
  "name": "server-trust-group-test",
  "properties": {
    "groupMembers": [
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-1"
      },
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-2"
      }
    ],
    "trustScopes": [
      "GlobalTransactions",
      "ServiceBroker"
    ]
  },
  "type": "Microsoft.Sql/locations/serverTrustGroups"
}

Status code:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/serverTrustGroups/server-trust-group-test",
  "name": "server-trust-group-test",
  "properties": {
    "groupMembers": [
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-1"
      },
      {
        "serverId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/managedInstance-2"
      }
    ],
    "trustScopes": [
      "GlobalTransactions",
      "ServiceBroker"
    ]
  },
  "type": "Microsoft.Sql/locations/serverTrustGroups"
}

Status code:: 202

定义

名称	说明
ServerInfo	服务器信任组的服务器信息。
ServerTrustGroup	服务器信任组。
TrustScopes	服务器信任组的信任范围。

ServerInfo

服务器信任组的服务器信息。

名称	类型	说明
serverId	string	服务器 ID。

ServerTrustGroup

服务器信任组。

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.groupMembers	ServerInfo[]	服务器信任组的组成员信息。
properties.trustScopes	TrustScopes[]	服务器信任组的信任范围。
type	string	资源类型。

TrustScopes

服务器信任组的信任范围。

名称	类型	说明
GlobalTransactions	string
ServiceBroker	string