# Alibaba Cloud Resource Sharing API

> Alibaba Cloud Resource Sharing API on Apizie: 26 endpoints (Accepts a resource sharing invitation, Associates shared resources or principals with a resource share, Associates permissions with a resource share, Transfers a resource share from one resource group to another, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-resourcesharing`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/resourcesharing
- Page: https://zieapi.vercel.app/api/cloud/aliyun-resourcesharing
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-resourcesharing/openapi.json

Alibaba Cloud OpenAPI for Resource Sharing (resourcesharing, version 2020-01-10). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Accepts a resource sharing invitation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/accept-resource-share-invitation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceShareInvitationId | string | yes | The ID of the sharing invitation. You can call the https://help.aliyun.com/document_detail/450564.html operation to obtain the ID of the… |

### Associates shared resources or principals with a resource share
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/associate-resource-share` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceShareId | string | yes | The ID of the resource share |
| Resources | string | no | The resources to associate with the resource share (JSON-encoded) |
| Targets | string | no | The principals to associate with the resource share (JSON-encoded) |
| ResourceArns | string | no | The ARNs of the shared resources. You can specify up to five resources in a single request (JSON-encoded) |
| PermissionNames | string | no | The names of the permissions to apply. If this parameter is omitted, the system automatically applies the default permission for the… |
| TargetProperties | string | no | The properties of the principals. This parameter applies only when a principal is an Alibaba Cloud service (JSON-encoded) |
| ResourceProperties | string | no | The properties of the resources (JSON-encoded) |

### Associates permissions with a resource share
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/associate-resource-share-permission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceShareId | string | yes | The ID of the resource share |
| PermissionName | string | yes | The name of the permission |
| Replace | string | no | Specifies whether to use the specified permission to replace an existing permission. Valid values: false: does not use the specified… |

### Transfers a resource share from one resource group to another
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/change-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceId | string | yes | The ID of the resource share |
| ResourceRegionId | string | yes | The ID of the region where the resource share resides |
| ResourceGroupId | string | yes | The destination resource group |

### Checks the status of resource sharing within a resource directory
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/check-sharing-with-resource-directory-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |

### Creates a resource share
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/create-resource-share` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceShareName | string | yes | The name of the resource share. The name must be 1 to 50 characters in length. It can contain letters, digits, Chinese characters, periods… |
| Resources | string | no | A list of shared resources (JSON-encoded) |
| Targets | string | no | A list of principals (JSON-encoded) |
| ResourceArns | string | no | The Alibaba Cloud Resource Names (ARNs) of the shared resources. You can add up to five shared resources at a time (JSON-encoded) |
| PermissionNames | string | no | The name of the permission. If unspecified, the system attaches the default permission for the resource type. For details, see… |
| AllowExternalTargets | string | no | Specifies whether to allow sharing with accounts outside your resource directory. Valid values: `false` (default): Resources can be shared… |
| ResourceGroupId | string | no | The ID of the resource group |
| TargetProperties | string | no | The properties of the principal. This parameter is available only when the principal is an Alibaba Cloud service (JSON-encoded) |
| ResourceProperties | string | no | A list of resource properties (JSON-encoded) |
| Tag | string | no | The tags of the resource share. You can add a maximum of 20 tags (JSON-encoded) |

### Deletes a resource share
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/delete-resource-share` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceShareId | string | yes | The ID of the resource share |

### Queries the regions where the Resource Sharing service is available
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/describe-regions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| AcceptLanguage | string | no | The supported natural language. Valid values: zh-CN: Chinese en-US: English |

### Disassociates shared resources or principals from a resource share
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/disassociate-resource-share` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceShareId | string | yes | The ID of the resource share |
| Resources | string | no | A list of shared resources to disassociate from the resource share (JSON-encoded) |
| Targets | string | no | A list of principals to disassociate from the resource share (JSON-encoded) |
| ResourceArns | string | no | A list of the Alibaba Cloud Resource Names (ARNs) of the shared resources. You can disassociate up to five shared resources in a single… |
| ResourceOwner | string | no | The owner of the resource share. Valid values: `Self` (default): The resource share is owned by the current account. Use this value when a… |

### Disassociates a permission from a resource share. You can disassociate a permission from a resource share…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/disassociate-resource-share-permission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceShareId | string | yes | The ID of the resource share |
| PermissionName | string | yes | The name of the permission. For more information, see https://help.aliyun.com/document_detail/465474.html |

### Enables resource sharing for a resource directory
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/enable-sharing-with-resource-directory` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |

### Queries the information about a permission
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/get-permission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| PermissionName | string | yes | The name of the permission |
| PermissionVersion | string | no | The version of the permission |

### Queries the versions of a permission
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/list-permission-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| PermissionName | string | yes | The name of the permission |
| MaxResults | integer | no | The maximum number of entries to return for a single request. Valid values: 1 to 100. Default value: 20 |
| NextToken | string | no | The `token` that is used to initiate the next request. If the response of the current request is truncated, you can use the token to… |

### Queries the information about the default permission
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/list-permissions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceType | string | no | The type of the shared resources. For more information about the types of resources that can be shared, see… |
| MaxResults | integer | no | The maximum number of entries to return for a single request. Valid values: 1 to 100. Default value: 20 |
| NextToken | string | no | The `token` that is used to initiate the next request. If the response of the current request is truncated, you can use the token to… |

### Lists the resources or principals that are associated with a resource share
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/list-resource-share-associations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceId | string | no | The ID of the resource. This parameter is not available when `AssociationType` is set to `Target` |
| ResourceArn | string | no | The Alibaba Cloud Resource Name (ARN) of the resource. This parameter is not available when `AssociationType` is set to `Target` |
| Target | string | no | The ID of the principal. This parameter is not available when `AssociationType` is set to `Resource` |
| AssociationType | string | yes | The type of the association. Valid values: `Resource`: Returns associations with shared resources. `Target`: Returns associations with… |
| AssociationStatus | string | no | The status of the association. Valid values: `Associating`: The association is in progress. `Associated`: The association is established.… |
| MaxResults | integer | no | The maximum number of entries to return per page. Valid values: 1 to 100. Default value: 20 |
| NextToken | string | no | The token for the next page of results. If the previous response was truncated, include this `token` to retrieve the remaining results |
| ResourceShareIds | string | no | The IDs of the resource shares. You can specify up to 5 resource share IDs (JSON-encoded) |

### Queries the resource sharing invitations that you have received
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/list-resource-share-invitations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| MaxResults | integer | no | The maximum number of entries to return for a single request. Valid values: 1 to 100. Default value: 20 |
| NextToken | string | no | The pagination token that is used in the next request to retrieve a new page of results. If the response is truncated, you can use this… |
| ResourceShareIds | string | no | The IDs of the resource shares (JSON-encoded) |
| ResourceShareInvitationIds | string | no | The IDs of the resource sharing invitations (JSON-encoded) |

### Queries the permissions that are associated with a resource share
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/list-resource-share-permissions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceShareId | string | yes | The ID of the resource share |
| MaxResults | integer | no | The maximum number of entries to return for a single request. Valid values: 1 to 100. Default value: 20 |
| NextToken | string | no | The `token` that is used to initiate the next request. If the response of the current request is truncated, you can use the token to… |
| ResourceOwner | string | yes | The owner of the resource share. Valid values: Self: the current account OtherAccounts: an account other than the current account |

### Queries resource shares
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/list-resource-shares` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceOwner | string | yes | The owner of the resource shares. Valid values: Self: the current account OtherAccounts: an account other than the current account |
| ResourceShareName | string | no | The name of the resource share |
| ResourceShareStatus | string | no | The status of the resource shares. Valid values: Active Pending Deleting Deleted The system automatically deletes the records of resource… |
| MaxResults | integer | no | The maximum number of entries to return for a single request. Valid values: 1 to 100. Default value: 20 |
| NextToken | string | no | The `token` that is used to initiate the next request if the response of the current request is truncated. You can use the token to… |
| ResourceShareIds | string | no | The IDs of the resource shares. Valid values of N: 1 to 5. This indicates that a maximum of five resource shares can be specified at a… |
| PermissionName | string | no | The information about the permissions. For more information, see https://help.aliyun.com/document_detail/465474.html |
| ResourceGroupId | string | no | The ID of the resource group |
| Tag | string | no | The tags (JSON-encoded) |

### Queries the resources you share with other accounts or the resources other accounts share with you
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/list-shared-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceOwner | string | yes | The owner of the resource share. Valid values: Self: Queries the resources that you shared with other accounts from your resource shares.… |
| ResourceType | string | no | The type of the shared resource. For more information about the resource types that can be shared, see… |
| Target | string | no | The ID of the principal or resource owner. If you set `ResourceOwner` to `Self`, this parameter is the ID of a principal. If you set… |
| MaxResults | integer | no | The maximum number of entries to return for a single request. Valid values: 1 to 100. Default value: 20 |
| NextToken | string | no | The pagination token that is used in the next request to retrieve a new page of results. If the response is truncated, you can use this… |
| ResourceShareIds | string | no | The ID of the resource share. The value of N ranges from 1 to 5. You can specify up to 5 resource share IDs (JSON-encoded) |
| ResourceIds | string | no | The ID of the shared resource. The value of N ranges from 1 to 5. You can specify up to 5 shared resource IDs (JSON-encoded) |
| ResourceArns | string | no | A list of Alibaba Cloud Resource Names (ARNs) of the shared resources. The value of N ranges from 1 to 5. You can specify up to 5 shared… |

### Queries a list of principals
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/list-shared-targets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceOwner | string | yes | The owner of the resource share. Self: Queries the principals that are associated with the resource shares you created. OtherAccounts:… |
| ResourceType | string | no | The type of the shared resource. For more information about the resource types that can be shared, see… |
| ResourceId | string | no | The ID of the shared resource |
| ResourceArn | string | no | The Alibaba Cloud Resource Name (ARN) of the shared resource |
| MaxResults | integer | no | The maximum number of entries to return for a single request. Valid values: 1 to 100. Default value: 20 |
| NextToken | string | no | The pagination token that is used in the next request to retrieve a new page of results. If the response is truncated, you can use this… |
| ResourceShareIds | string | no | The IDs of resource shares. The value of N can be from 1 to 5. You can specify up to 5 resource share IDs (JSON-encoded) |
| Targets | string | no | The principals (JSON-encoded) |

### Queries the tags attached to one or more resource shares
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/list-tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceType | string | yes | The resource type. Set the value to `ResourceShare`, which indicates a resource share |
| ResourceId | string | no | The IDs of the resource shares. You can specify up to 20 resource share IDs (JSON-encoded) |
| RegionId | string | yes | The ID of the region to which the resource share belongs |
| Tag | string | no | The tags. You can specify up to 20 tags (JSON-encoded) |
| NextToken | string | no | The pagination token that is used in the next request to retrieve a new page of results. If the response of the current request is… |

### Rejects a resource sharing invitation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/reject-resource-share-invitation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceShareInvitationId | string | yes | The ID of the resource sharing invitation. You can call the https://help.aliyun.com/document_detail/450564.html operation to obtain the ID… |

### Attaches tags to resource shares
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceType | string | yes | The type of the resource. Set this parameter to `ResourceShare`, which indicates a resource share |
| ResourceId | string | yes | The IDs of the resource shares (JSON-encoded) |
| RegionId | string | yes | The ID of the region where the resource share resides |
| Tag | string | yes | The tags. You can attach up to 20 tags (JSON-encoded) |

### Removes tags from one or more resource shares
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/untag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceType | string | yes | The resource type. Set this parameter to `ResourceShare`, which indicates a resource share |
| ResourceId | string | no | The IDs of the resource shares. You can specify up to 20 resource share IDs (JSON-encoded) |
| RegionId | string | yes | The ID of the region where the resource share resides |
| TagKey | string | no | The tag keys. You can remove up to 20 tag keys. You do not need to specify tag keys if you set the `All` parameter to `true` (JSON-encoded) |
| All | string | no | Specifies whether to remove all tags from the specified resources. Valid values: false true Default value: false |

### Modifies the information of a resource share
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/update-resource-share` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |
| ResourceShareId | string | yes | The ID of the resource share |
| ResourceShareName | string | yes | The new name for the resource share. The name must be 1 to 50 characters in length. It can contain letters, digits, periods (.),… |
| AllowExternalTargets | string | no | Specifies whether to share resources with accounts outside your resource directory. Valid values: false true |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://resourcesharing.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/accept-resource-share-invitation" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Resource Sharing API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-resourcesharing/accept-resource-share-invitation with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Resource Sharing API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Resource Sharing itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Resource Sharing API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-resourcesharing.

### What is the status of the Alibaba Cloud Resource Sharing API?
Needs your own provider key (bring your own key)