Todos os produtos
Search
Central de documentação

Resource Management:AssociateMembers

Última atualização: Jul 04, 2026

Vincula um contato a um diretório de recursos, pasta ou membro.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ContactId

string

Não

O ID do contato.

c-qL4HqKONzOM7****

Members

array

Não

Os IDs dos objetos aos quais você deseja vincular o contato.

string

Não

O ID do objeto ao qual você deseja vincular o contato. Valores válidos:

  • ID de um diretório de recursos

  • ID de uma pasta

  • ID de um membro

Valores válidos de N: 1 a 5. Isso indica que podem ser especificados no máximo cinco objetos por vez.

fd-ZDNPiT****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O resultado retornado.

RequestId

string

O ID da solicitação.

95060F1D-6990-4645-8920-A81D1BBFE992

Members

array<object>

A hora em que o contato foi vinculado ao objeto.

object

ContactId

string

O ID do contato.

c-qL4HqKONzOM7****

MemberId

string

O ID do objeto. Valores válidos:

  • ID do diretório de recursos

  • ID da pasta

  • ID do membro

fd-ZDNPiT****

ModifyDate

string

A hora em que o contato foi vinculado ao objeto.

2023-03-27 17:19:21

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "95060F1D-6990-4645-8920-A81D1BBFE992",
  "Members": [
    {
      "ContactId": "c-qL4HqKONzOM7****",
      "MemberId": "fd-ZDNPiT****",
      "ModifyDate": "2023-03-27 17:19:21"
    }
  ]
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter.ContactId The ContactId is invalid.
400 MissingParameter.ContactId You must specify ContactId.
400 InvalidParameter.Members The Members is invalid.
400 InvalidParameter.Members.Duplicate The Members contains duplicate values.
400 LimitExceeded.ContactMembers The maximum number of contact members exceeds the limit.
400 InvalidMember The member does not exist in the resource directory.
400 ContactStatusMismatchAction The status of the contact does not allow the specified operation.
404 EntityNotExists.Contact This Contact does not exist.
429 ConcurrentCallNotSupported The operation conflicts with other operations. Please try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.