Server Trust Groups - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Cria ou atualiza um grupo de confiança do servidor.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
locationName	path	True	string	O nome da região em que o recurso está localizado.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverTrustGroupName	path	True	string	O nome do grupo de confiança do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
properties.groupMembers	True	ServerInfo[]	Informações de membros do grupo para o grupo de confiança do servidor.
properties.trustScopes	True	TrustScopes[]	Escopo de confiança do grupo de confiança do servidor.

Respostas

Nome	Tipo	Description
200 OK	ServerTrustGroup	O grupo de confiança do servidor foi atualizado com êxito.
201 Created	ServerTrustGroup	O grupo de confiança do servidor foi criado com êxito.
202 Accepted		Aceito
Other Status Codes		Respostas de erro: *** 400 ServerTrustGroupCreateRequestInvalid - O recurso ou as propriedades do recurso no corpo da solicitação estão vazias ou inválidas 400 ServerTrustGroupCreateRequestInvalidGroupMembers - A propriedade membros do grupo no corpo da solicitação está vazia ou inválida 400 ServerTrustGroupCreateRequestInvalidGroupMembersCount - A propriedade membros do grupo tem um número inválido de servidores 400 ServerTrustGroupCreateRequestInvalidServer - O campo serverId especificado no corpo da solicitação do grupo de confiança do servidor é vazio ou inválido 400 ServerTrustGroupCreateRequestDuplicateServer – um ou mais dos servidores fornecidos são duplicados. 400 ServerTrustGroupCreateRequestInvalidTrustScopes - A propriedade de escopo de confiança no corpo da solicitação é vazia ou inválida. 400 ServerTrustGroupCreateRequestInvalidTrustScopesValue - A propriedade de escopo de confiança no corpo da solicitação tem um valor inválido. 400 ServerTrustGroupCreateRequestInvalidGroupMembersCount2 - A propriedade membros do grupo tem um número inválido de servidores 404 ServerTrustGroupNotFound - O grupo de confiança do servidor com o nome especificado não existe. 404 OperationIdNotFound - A operação com Id não existe. 404 ResourceNotFound - O recurso solicitado não foi encontrado. 404 OperationIdNotFound - A operação com Id não existe. 406 ServerTrustGroupMemberIsBusy - O membro do grupo '{0}' não está em um estado válido e não pode executar a operação de grupo de confiança do servidor. 406 ServerTrustGroupInInvalidState - O grupo de confiança do SQL '{0}' está ocupado e não pode executar a operação solicitada. 406 ServerTrustGroupMemberNotFound - O membro do grupo '{0}' não foi encontrado, portanto, não podemos executar a operação de grupo de confiança do servidor. 409 OperationCancelled - A operação foi cancelada pelo usuário. 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

Exemplos

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

Resposta de exemplo

Código de status:: 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"
}

Código de status:: 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"
}

Código de status:: 202

Definições

Nome	Description
ServerInfo	Informações do servidor para o grupo de confiança do servidor.
ServerTrustGroup	Um grupo de confiança do servidor.
TrustScopes	Escopo de confiança do grupo de confiança do servidor.

ServerInfo

Informações do servidor para o grupo de confiança do servidor.

Nome	Tipo	Description
serverId	string	ID do servidor.

ServerTrustGroup

Um grupo de confiança do servidor.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.groupMembers	ServerInfo[]	Informações de membros do grupo para o grupo de confiança do servidor.
properties.trustScopes	TrustScopes[]	Escopo de confiança do grupo de confiança do servidor.
type	string	Tipo de recurso.

TrustScopes

Escopo de confiança do grupo de confiança do servidor.

Nome	Tipo	Description
GlobalTransactions	string
ServiceBroker	string

Compartilhar via