Server Trust Groups - Create Or Update

リファレンス

サービス:: SQL Database

API バージョン:: 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 - 指定された 1 つ以上のサーバーが重複しています。 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 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。 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.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)),
            com.azure.core.util.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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
}

状態コード:: 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

次の方法で共有

Server Trust Groups - Create Or Update

URI パラメーター

要求本文

応答

例

Create server trust group

要求のサンプル

応答のサンプル

定義

ServerInfo

ServerTrustGroup

TrustScopes

その他のリソース