被邀請的阿里云賬號調用AcceptHandshake接受邀請。

使用說明

被邀請的阿里云賬號成功加入資源目錄后，會成為資源目錄的成員。資源目錄默認使用被邀請的阿里云賬號名稱作為該成員的成員名稱和賬號名稱。

本文將提供一個示例，被邀請的阿里云賬號177242285274****接受來自資源目錄rd-3G****的邀請，邀請ID是h-Ih8IuPfvV0t0****。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 AcceptHandshake

要執行的操作。取值：AcceptHandshake。

HandshakeId String 是 h-Ih8IuPfvV0t0****

邀請ID。

您可以調用ListHandshakesForAccount獲取邀請ID。

關于公共請求參數的詳情，請參見公共參數。

返回數據

名稱 類型 示例值 描述
RequestId String 5828C836-3286-49A6-9006-15231BB19342

請求ID。
Handshake Object

邀請信息。
Status String Accepted

邀請狀態。取值：

  • Pending：等待確認。
  • Accepted：已接受。
  • Cancelled：已取消。
  • Declined：已拒絕。
  • Expired：超時。
ExpireTime String 2021-01-20T02:15:40Z

邀請的過期時間（UTC時間）。
ResourceDirectoryId String rd-3G****

資源目錄ID。
CreateTime String 2021-01-06T02:15:40Z

邀請的創建時間（UTC時間）。
Note String 歡迎您加入

備注。
TargetEntity String 177242285274****

被邀請的阿里云賬號ID或登錄郵箱。
MasterAccountId String 151266687691****

資源目錄的管理賬號ID。
MasterAccountName String CompanyA

資源目錄的管理賬號名稱。
ModifyTime String 2021-01-06T02:16:40Z

邀請的修改時間（UTC時間）。
TargetType String Account

被邀請的阿里云賬號類型。取值：

  • Account：阿里云賬號ID。
  • Email：阿里云賬號登錄郵箱。
HandshakeId String h-Ih8IuPfvV0t0****

邀請ID。

示例

請求示例

https://resourcemanager.aliyuncs.com/?Action=AcceptHandshake
&HandshakeId=h-Ih8IuPfvV0t0****
&<公共請求參數>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<AcceptHandshakeResponse>
    <RequestId>5828C836-3286-49A6-9006-15231BB19342</RequestId>
    <Handshake>
        <Status>Accepted</Status>
        <ModifyTime>2021-01-06T02:16:40Z</ModifyTime>
        <ResourceDirectoryId>rd-3G****</ResourceDirectoryId>
        <HandshakeId>h-Ih8IuPfvV0t0****</HandshakeId>
        <Note>歡迎您加入</Note>
        <CreateTime>2021-01-06T02:15:40Z</CreateTime>
        <TargetType>Account</TargetType>
        <MasterAccountId>151266687691****</MasterAccountId>
        <MasterAccountName>CompanyA</MasterAccountName>
        <ExpireTime>2021-01-20T02:15:40Z</ExpireTime>
        <TargetEntity>177242285274****</TargetEntity>
    </Handshake>
</AcceptHandshakeResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

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

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 MissingParameter.HandshakeId You must specify HandshakeId. 邀請ID缺失，請指定目標ID。
400 InvalidParameter.HandshakeId The HandshakeId is invalid. 邀請ID無效，邀請ID應以“h-”開頭+16位數字或英文字母。
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. 您的賬號非企業類型實名，無法接受邀請。

訪問錯誤中心查看更多錯誤碼。