Todos os produtos
Search
Central de documentação

Resource Management:AcceptHandshake

Última atualização: Jul 04, 2026

Aceita um convite.

Descrição da operação

Depois que uma conta Alibaba Cloud convidada entra em um diretório de recursos, ela se torna um membro do diretório de recursos. Por padrão, o nome da conta Alibaba Cloud convidada é usado como o nome de exibição da conta no diretório de recursos.

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

HandshakeId

string

Sim

O ID do convite.

Você pode chamar a operação ListHandshakesForAccount para obter o ID.

h-Ih8IuPfvV0t0****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O resultado retornado.

RequestId

string

O ID da solicitação.

5828C836-3286-49A6-9006-15231BB19342

Handshake

object

As informações do convite.

Status

string

O status do convite. Valores válidos:

  • Pending: O convite está aguardando confirmação.

  • Accepted: O convite foi aceito.

  • Cancelled: O convite foi cancelado.

  • Declined: O convite foi recusado.

  • Expired: O convite expirou.

Accepted

ExpireTime

string

A hora em que o convite expira. A hora é exibida em UTC.

2021-01-20T02:15:40Z

ResourceDirectoryId

string

O ID do diretório de recursos.

rd-3G****

CreateTime

string

A hora em que o convite foi criado. A hora é exibida em UTC.

2021-01-06T02:15:40Z

Note

string

A descrição do convite.

Welcome

TargetEntity

string

O ID ou o endereço de e-mail de logon da conta Alibaba Cloud convidada.

177242285274****

MasterAccountId

string

O ID da conta de gerenciamento do diretório de recursos.

151266687691****

MasterAccountName

string

O nome da conta de gerenciamento do diretório de recursos.

CompanyA

ModifyTime

string

A hora em que o convite foi modificado. A hora é exibida em UTC.

2021-01-06T02:16:40Z

TargetType

string

O tipo da conta Alibaba Cloud convidada. Valores válidos:

  • Account: indica o ID da conta Alibaba Cloud.

  • Email: indica o endereço de e-mail de logon da conta Alibaba Cloud.

Account

HandshakeId

string

O ID do convite.

h-Ih8IuPfvV0t0****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "5828C836-3286-49A6-9006-15231BB19342",
  "Handshake": {
    "Status": "Accepted",
    "ExpireTime": "2021-01-20T02:15:40Z",
    "ResourceDirectoryId": "rd-3G****",
    "CreateTime": "2021-01-06T02:15:40Z",
    "Note": "Welcome\n",
    "TargetEntity": "177242285274****",
    "MasterAccountId": "151266687691****",
    "MasterAccountName": "CompanyA",
    "ModifyTime": "2021-01-06T02:16:40Z",
    "TargetType": "Account",
    "HandshakeId": "h-Ih8IuPfvV0t0****"
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 MissingParameter.HandshakeId You must specify HandshakeId.
400 InvalidParameter.HandshakeId The HandshakeId is invalid.
404 EntityNotExists.Handshake The specified handshake does not exist.
404 SpecifiedResourceDirectoryNotExists The specified resource directory does not exist. You must specify a valid resource directory.
409 HandshakeStatusMismatch The invitation is invalid.
409 NotSupport.AccountInAnotherResourceDirectory Your account is a management account for another resource directory or a member of another resource directory.
409 Invalid.AccountType The specified profile type of account is invalid.
409 NotSupport.Account.RealNameType Your account is not a real-name of enterprise type, so you cannot accept the invitation.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.