Disassociates resources or accounts from a resource share.
In this example, the account 172050525300****
is disassociated from the resource share rs-6GRmdD3X****
in the cn-hangzhou
region. This indicates that the account cannot share the resources associated with
the resource share.
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DisassociateResourceShare |
The operation that you want to perform. Set the value to DisassociateResourceShare. |
RegionId | String | Yes | cn-hangzhou |
The region ID. For more information about regions where the Resource Sharing service is available, see DescribeRegions. |
ResourceShareId | String | Yes | rs-6GRmdD3X**** |
The ID of the resource share. |
Resources.N.ResourceId | String | No | vsw-bp183p93qs667muql**** |
The ID of the shared resource. Valid values of N: 1 to 5. This indicates that a maximum of five shared resources can be specified at a time. Note Resources.N.ResourceId and Resources.N.ResourceType must be used in pairs.
|
Resources.N.ResourceType | String | No | VSwitch |
The type of the shared resource. Valid values of N: 1 to 5. This indicates that a maximum of five shared resources can be specified at a time. Set the value to VSwitch. Note Resources.N.ResourceId and Resources.N.ResourceType must be used in pairs.
|
Targets.N | RepeatList | No | 172050525300**** |
The shared target. A shared target shares the resources of resource owners. You can share your resources only with the member accounts in your resource directory. A shared target is indicated by its account ID. For more information about how to obtain the ID, see View the basic information of a member account. Valid values of N: 1 to 5. This indicates that a maximum of five shared targets can be specified at a time. |
For more information about common parameters, see Common parameters.
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 95230BC9-A8E8-4493-96BD-4F0C758E37F8 |
The ID of the request. |
ResourceShareAssociations | Array of ResourceShareAssociation |
The information of the entities that are disassociated from the resource share. |
|
AssociationStatus | String | Disassociating |
The association status. Valid values:
Note The system automatically deletes the records of entities in the
Failed or Disassociated state within 48 hours to 96 hours.
|
AssociationStatusMessage | String | The reason for the association failure. |
The cause of the association failure. |
AssociationType | String | Target |
The association type. Valid values:
|
CreateTime | String | 2020-12-04T09:40:41.250Z |
The time when the disassociation was performed. The value of this parameter depends on the value of the AssociationType parameter:
|
EntityId | String | 172050525300**** |
The ID of the entity. The value of this parameter depends on the value of the AssociationType parameter:
|
EntityType | String | Account |
The type of the entity. The value of this parameter depends on the value of the AssociationType parameter:
|
ResourceShareId | String | rs-6GRmdD3X**** |
The ID of the resource share. |
ResourceShareName | String | test |
The name of the resource share. |
UpdateTime | String | 2020-12-04T09:40:45.556Z |
The time when the disassociation was updated. The value of this parameter depends on the value of the AssociationType parameter:
|
Examples
Sample requests
https://resourcesharing.aliyuncs.com/?Action=DisassociateResourceShare
&RegionId=cn-hangzhou
&ResourceShareId=rs-6GRmdD3X****
&Targets.1=172050525300****
&<Common request parameters>
Sample success responses
XML
format
<DisassociateResourceShareResponse>
<ResourceShareAssociations>
<ResourceShareId>rs-6GRmdD3X****</ResourceShareId>
<EntityId>172050525300****</EntityId>
<EntityType>Account</EntityType>
<AssociationStatusMessage></AssociationStatusMessage>
<AssociationType>Target</AssociationType>
<CreateTime>2020-12-04T09:40:41.250Z</CreateTime>
<UpdateTime>2020-12-04T09:40:45.556Z</UpdateTime>
<ResourceShareName>test</ResourceShareName>
<AssociationStatus>Disassociating</AssociationStatus>
</ResourceShareAssociations>
<RequestId>95230BC9-A8E8-4493-96BD-4F0C758E37F8</RequestId>
</DisassociateResourceShareResponse>
JSON
format
{
"ResourceShareAssociations": [
{
"ResourceShareId": "rs-6GRmdD3X****",
"EntityId": "172050525300****",
"EntityType": "Account",
"AssociationStatusMessage": "",
"AssociationType": "Target",
"CreateTime": "2020-12-04T09:40:41.250Z",
"UpdateTime": "2020-12-04T09:40:45.556Z",
"ResourceShareName": "test",
"AssociationStatus": "Disassociating"
}
],
"RequestId": "95230BC9-A8E8-4493-96BD-4F0C758E37F8"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | MissingParameter.ResourceShareId | You must specify ResourceShareId. | The error message returned because the ResourceShareId parameter is not specified. |
400 | InvalidParameter.ResourceShareId | The ResourceShareId is invalid. | The error message returned because the value of the ResourceShareId parameter is invalid. |
400 | InvalidParameter.Resources | The Resources is invalid. | The error message returned because the specified resource is invalid. |
400 | InvalidParameter.Resources.Length | The maximum number of Resources exceeds 5. | The error message returned because the number of specified resources has exceeded the upper limit. Specify a maximum of five resources. |
400 | InvalidParameter.Resources.Duplicate | The Resources contains duplicate values. | The error message returned because duplicate resources are specified. |
400 | InvalidParameter.Targets | The Targets is invalid. | The error message returned because the value of the Targets parameter is invalid. |
400 | InvalidParameter.Targets.Length | The maximum number of Targets exceeds 5. | The error message returned because the number of specified accounts has exceeded the upper limit. Specify a maximum of five accounts. |
400 | InvalidParameter.Targets.Duplicate | The Targets contains duplicate values. | The error message returned because duplicate accounts are specified. |
409 | AccountNotInResourceDirectory | The account is not a master or a member of a resource directory. | The error message returned because the specified account is not in your resource directory. |
404 | EntityNotExists.ResourceShare | The resource share does not exist in the current account. | The error message returned because the resource share does not belong to your Alibaba Cloud account. |
409 | ResourceShareStatusMismatchAction | The status of the resource share does not allow the specified operation. | The error message returned because the operation is not supported while the resource share is in the current state. |
400 | ResourceAndTargetBothEmpty | Either a resource or a shared target must be specified. | The error message returned because no resources or accounts are specified. |
409 | DisassociateConflict | You cannot perform the operation while association is already in progress. | The error message returned because the operation is not supported while an association is being performed. |
400 | DisassociateInvalid | You can not disassociate unassociated resource or target. | The error message returned because the operation is not supported for an entity that is not associated with the resource share. |
400 | InvalidParameter | The specified parameter is invalid. | The error message returned because a specified parameter is invalid. |
For a list of error codes, visit the API Error Center.