Todos os produtos
Search
Central de documentação

Resource Management:ListHandshakesForAccount

Última atualização: Jul 04, 2026

Consulta os convites associados a uma conta.

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

PageNumber

integer

Não

O número da página a ser retornada.

As páginas começam na página 1. Valor padrão: 1.

1

PageSize

integer

Não

O número de entradas a serem retornadas em cada página.

Valores válidos: 1 a 100. Valor padrão: 10.

10

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O resultado retornado.

TotalCount

integer

O número total de convites.

2

RequestId

string

O ID da solicitação.

9B34724D-54B0-4A51-B34D-4512372FE1BE

PageSize

integer

O número de entradas retornadas por página.

10

PageNumber

integer

O número da página retornada.

1

Handshakes

object

Handshake

array<object>

As informações dos convites.

object

As informações de um convite.

Status

string

The status of the invitation. Valid values:

  • Pending: The invitation is waiting for confirmation.

  • Accepted: The invitation is accepted.

  • Cancelled: The invitation is canceled.

  • Declined: The invitation is rejected.

  • Expired: The invitation expires.

Pending

ExpireTime

string

The time when the invitation expires. The time is displayed in UTC.

2018-08-24T09:55:41Z

ResourceDirectoryId

string

The ID of the resource directory.

rd-abcdef****

CreateTime

string

The time when the invitation was created. The time is displayed in UTC.

2018-08-10T09:55:41Z

Note

string

The description of the invitation.

Welcome

TargetEntity

string

The ID or logon email address of the invited Alibaba Cloud account.

someone@example.com

MasterAccountId

string

The ID of the management account of the resource directory.

172841235500****

MasterAccountName

string

The name of the management account of the resource directory.

CompanyA

ModifyTime

string

The time when the invitation was modified. The time is displayed in UTC.

2018-08-10T09:55:41Z

TargetType

string

The type of the invited Alibaba Cloud account. Valid values:

  • Account: indicates the ID of the account.

  • Email: indicates the logon email address of the account.

Email

HandshakeId

string

The ID of the invitation.

h-4N57QZzCTtES****

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 2,
  "RequestId": "9B34724D-54B0-4A51-B34D-4512372FE1BE",
  "PageSize": 10,
  "PageNumber": 1,
  "Handshakes": {
    "Handshake": [
      {
        "Status": "Pending",
        "ExpireTime": "2018-08-24T09:55:41Z",
        "ResourceDirectoryId": "rd-abcdef****",
        "CreateTime": "2018-08-10T09:55:41Z",
        "Note": "Welcome\n",
        "TargetEntity": "someone@example.com",
        "MasterAccountId": "172841235500****",
        "MasterAccountName": "CompanyA",
        "ModifyTime": "2018-08-10T09:55:41Z",
        "TargetType": "Email",
        "HandshakeId": "h-4N57QZzCTtES****"
      }
    ]
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.