# Alibaba Cloud Simple Message Queue (formerly MNS) API

> Alibaba Cloud Simple Message Queue (formerly MNS) API on Apizie: 27 endpoints (Adds one or more ACL rules for an access point of a specified type, Creates an event rule, Calls the CreateQueue operation to create a queue, Creates a topic, …) 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://apizie.tech/v1/cloud:aliyun-mns-open/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-mns-open`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/mns-open
- Page: https://apizie.tech/api/cloud/aliyun-mns-open
- OpenAPI: https://apizie.tech/api/cloud/aliyun-mns-open/openapi.json

Alibaba Cloud OpenAPI for Simple Message Queue (formerly MNS) (mns-open, version 2022-01-19). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Adds one or more ACL rules for an access point of a specified type
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/authorize-endpoint-acl` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| EndpointType | string | yes | The access point type. Valid values: public: public access point. Currently, only public is supported |
| AclStrategy | string | yes | The ACL policy. Valid values: allow: CIDR whitelist. Currently, only allow is supported |
| CidrList | string | yes | The list of CIDR blocks (JSON-encoded) |

### Creates an event rule
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/create-event-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| ProductName | string | yes | The name of the cloud service for event notification |
| RuleName | string | yes | The name of the event notification rule |
| EventTypes | string | yes | The list of event types (JSON-encoded) |
| MatchRules | string | yes | The matching rules. Multiple rules have an OR relationship (JSON-encoded) |
| Endpoints | string | no | [Deprecated] Use Endpoint instead (JSON-encoded) |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can generate the token on your client to ensure that the token… |
| Endpoint | string | no | The endpoint address that receives messages for the subscription (JSON-encoded) |
| DeliveryMode | string | no | [Deprecated] This field is deprecated |

### Calls the CreateQueue operation to create a queue
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/create-queue` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| QueueName | string | yes | The name of the queue |
| MaximumMessageSize | integer | no | The maximum size of a message body that can be sent to the queue. Valid values: 1024 to 65536. Unit: bytes. Default value: 65536 |
| MessageRetentionPeriod | integer | no | The maximum duration for which a message is retained in the queue. After the specified duration elapses since a message is sent to the… |
| VisibilityTimeout | integer | no | The duration for which a message stays in the Inactive state after it is consumed from the queue and changes from the Active state to the… |
| PollingWaitSeconds | integer | no | The maximum duration for which a ReceiveMessage request waits when the queue has no messages. Valid values: 0 to 30. Unit: seconds.… |
| EnableLogging | string | no | Specifies whether to enable the Log Management feature. Valid values: true: Enabled. false: Disabled. Default value: false |
| DelaySeconds | integer | no | The delay period for all messages sent to the queue. A message sent to the queue can be consumed only after the delay period specified by… |
| Tag | string | no | The list of resource tags (JSON-encoded) |
| DlqPolicy | string | no | The dead-letter policy (JSON-encoded) |
| QueueType | string | no | The type of the queue. Valid values: normal: standard queue. fifo: FIFO queue |
| TenantRateLimitPolicy | string | no | The throttling policy (JSON-encoded) |
| EnableSSE | string | no | The EnableSSE |
| SseType | string | no | The SseType |
| SseAlgorithm | string | no | The SseAlgorithm |
| KmsKeyId | string | no | The KmsKeyId |

### Creates a topic
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/create-topic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| TopicName | string | yes | The name of the topic to create |
| EnableLogging | string | no | Specifies whether to enable Log Management. Valid values: true: Enabled. false: Disabled. Default value: false |
| MaxMessageSize | integer | no | The maximum size of a message body sent to the topic. Valid values: 1024 to 65536. Unit: bytes. Default value: 65536 |
| Tag | string | no | The list of resource tags (JSON-encoded) |
| TopicType | string | no | The topic type. Valid values: normal: normal topic fifo: FIFO topic |
| EnableSSE | string | no | The EnableSSE |
| SseType | string | no | The SseType |
| SseAlgorithm | string | no | The SseAlgorithm |
| KmsKeyId | string | no | The KmsKeyId |

### Deletes an event rule
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/delete-event-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| ProductName | string | yes | The name of the cloud service for event notifications |
| RuleName | string | yes | The name of the event notification rule |

### Deletes a queue
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/delete-queue` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| QueueName | string | yes | The name of the queue |

### Deletes a topic
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/delete-topic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| TopicName | string | yes | The name of the topic to delete |

### Disables access points of a specified type. After the access points are disabled, all requests originating…
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/disable-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| EndpointType | string | yes | The access point type. Valid values: public: public access point. (Currently, only public is supported.) |

### Enables an access point of a specified type. After the access point is enabled, requests from the…
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/enable-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| EndpointType | string | yes | The type of the access point. Valid values: public: the public access point. Currently, only public is supported |

### Retrieves the user log configuration
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/get-account-attributes` (byok)

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

### Retrieves the attributes of an endpoint
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/get-endpoint-attribute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| EndpointType | string | yes | The endpoint type. Valid values: public: Internet endpoint. Currently, only public is supported |

### Retrieves event notification rules
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/get-event-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| ProductName | string | yes | The name of the cloud service for event notifications |
| RuleName | string | yes | The name of the event notification rule |

### Retrieves the attributes of a specified queue
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/get-queue-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| QueueName | string | yes | The name of the queue |
| Tag | string | no | The list of resource tags (JSON-encoded) |

### Retrieves the attributes of a subscription
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/get-subscription-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| TopicName | string | yes | The name of the subscribed topic |
| SubscriptionName | string | yes | The name of the subscription |

### Retrieves the attributes of a topic
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/get-topic-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| TopicName | string | yes | The name of the topic |
| Tag | string | no | The list of resource tags (JSON-encoded) |

### Queries the list of event notifications
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/list-event-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| ProductName | string | no | The name of the cloud service for event notifications |
| ResourceName | string | no | The resource name in the matching rule, which is used to filter rules. For example, in OSS, this is the OSS bucket name |
| RuleName | string | no | The name of the rule |
| TopicName | string | no | The name of the topic |
| Subscription | string | no | The subscription endpoint (JSON-encoded) |
| PageNum | integer | no | The page number of the returned results. Valid values: 1 to 100000. If the specified value is less than 1, the system defaults to 1. If… |
| PageSize | integer | no | The number of entries to return on each page. Valid values: 10 to 50. If the specified value is less than 10, the system defaults to 10.… |
| NextToken | string | no | [Deprecated] Use PageNum for paging in a paged query |
| MaxResults | integer | no | [Deprecated] Use PageSize for paging in a paged query |

### Lists all queues under a specified Alibaba Cloud account with pagination support
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/list-queue` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| PageNum | integer | no | The page number of the returned results. Valid values: 1 to 100000000. If the specified value is less than 1, the system defaults to 1. If… |
| PageSize | integer | no | The number of entries to return on each page. Valid values: 10 to 50. If the specified value is less than 10, the system defaults to 10.… |
| QueueName | string | no | The name of the queue |
| Tag | string | no | The list of resource tags (JSON-encoded) |
| QueueType | string | no | The type of the queue. Valid values: normal: standard queue fifo: FIFO queue |

### Lists the subscriptions under a specified topic. The results can be paginated
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/list-subscription-by-topic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| TopicName | string | no | The name of the topic |
| PageNum | integer | no | The page number of the returned results. Valid values: 1 to 100000000. If you set this parameter to a value less than 1, the system… |
| PageSize | integer | no | The number of entries to return on each page. Valid values: 10 to 50. If you set this parameter to a value less than 10, the system… |
| SubscriptionName | string | no | The name of the subscription |
| EndpointType | string | no | The EndpointType |
| EndpointValue | string | no | The EndpointValue |

### Queries the topics under an Alibaba Cloud account. The query results can be paginated
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/list-topic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| PageNum | integer | no | The page number of the returned results. Valid values: 1 to 100000000. If the specified value is less than 1, the system defaults to 1. If… |
| PageSize | integer | no | The number of entries to return on each page. Valid values: 10 to 50. If the specified value is less than 10, the system defaults to 10.… |
| TopicName | string | no | The name of the topic |
| Tag | string | no | The list of tags (JSON-encoded) |
| TopicType | string | no | The type of the topic. Valid values: normal: normal topic fifo: FIFO topic |

### Deletes one or more ACL rules for an endpoint of a specified type
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/revoke-endpoint-acl` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| EndpointType | string | yes | The endpoint type. Valid values: public: The Internet-facing endpoint. Currently, only public is supported |
| AclStrategy | string | yes | The ACL policy. Valid values: allow: The CIDR whitelist. Currently, only allow is supported |
| CidrList | string | yes | The list of CIDR blocks (JSON-encoded) |

### Configures user log settings
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/set-account-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| MessageTraceEnabled | string | no | Specifies whether to enable the message trace feature |
| LogEnabled | string | no | Specifies whether to enable the log management feature |
| LogStoreName | string | no | The name of the Simple Log Service Logstore |
| ProjectName | string | no | The name of the Simple Log Service project |
| ClientToken | string | no | Ensures the idempotence of the request. You can generate the value on your client to ensure that the value is unique across different… |

### Modifies the attributes of a queue by calling the SetQueueAttributes operation
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/set-queue-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| QueueName | string | yes | The name of the queue |
| DelaySeconds | integer | no | The delay time for all messages sent to the queue. Messages sent to the queue become consumable only after the delay time specified by… |
| MaximumMessageSize | integer | no | The maximum length of the message body sent to the queue. Valid values: 1024 to 65536. Unit: bytes. Default value: 65536 |
| MessageRetentionPeriod | integer | no | The maximum lifetime of a message in the queue. After the time specified by this parameter elapses since the message is sent to the queue,… |
| VisibilityTimeout | integer | no | The duration for which a message stays in the Inactive state after it is consumed from the queue and changes from the Active state to the… |
| PollingWaitSeconds | integer | no | The maximum wait time for a ReceiveMessage request on the queue when no messages are available in the queue. Valid values: 0 to 30. Unit:… |
| EnableLogging | string | no | Specifies whether to enable the Log Management feature. Valid values: true: Enabled. false: Disabled. Default value: false |
| DlqPolicy | string | no | The dead-letter queue policy (JSON-encoded) |
| TenantRateLimitPolicy | string | no | The TenantRateLimitPolicy (JSON-encoded) |
| EnableSSE | string | no | The EnableSSE |
| SseType | string | no | The SseType |
| SseAlgorithm | string | no | The SseAlgorithm |
| KmsKeyId | string | no | The KmsKeyId |

### Modifies the attributes of a subscription
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/set-subscription-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| TopicName | string | yes | The name of the topic |
| SubscriptionName | string | yes | The name of the subscription |
| NotifyStrategy | string | no | The retry policy used when an error occurs while pushing messages to the endpoint. Valid values: BACKOFF_RETRY: backoff retry… |
| DlqPolicy | string | no | The dead-letter queue policy (JSON-encoded) |
| TenantRateLimitPolicy | string | no | The TenantRateLimitPolicy (JSON-encoded) |
| StsRoleArn | string | no | The STS role ARN |

### Calls the SetTopicAttributes operation to modify the attributes of a topic
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/set-topic-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| TopicName | string | yes | The name of the topic |
| EnableLogging | string | no | Specifies whether to enable the log management feature. Valid values: true: Enabled. false: Disabled. Default value: false |
| MaxMessageSize | integer | no | The maximum length of the message body sent to the topic. Valid values: 1024 to 65536. Unit: bytes. Default value: 65536 |
| EnableSSE | string | no | The EnableSSE |
| SseType | string | no | The SseType |
| SseAlgorithm | string | no | The SseAlgorithm |
| KmsKeyId | string | no | The KmsKeyId |

### Calls the Subscribe operation to create a subscription for a topic
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/subscribe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| TopicName | string | yes | The name of the topic |
| SubscriptionName | string | yes | The name of the subscription |
| PushType | string | yes | Push type of the subscription Valid values: `http`: HTTP/HTTPS push. Pushes messages to a specified HTTP or HTTPS callback URL. `queue`:… |
| Endpoint | string | yes | Endpoint address for receiving messages The format varies depending on the value of `PushType`: `PushType=http`: An HTTP/HTTPS callback… |
| NotifyStrategy | string | no | The retry strategy when an error occurs while pushing messages to the endpoint. Valid values: BACKOFF_RETRY: backoff retry.… |
| NotifyContentFormat | string | no | Format of the pushed message content Valid values: `XML`: The message body is pushed in XML format. This is the default value. `JSON`: The… |
| MessageTag | string | no | The tag used for message filtering in this subscription. Only messages with a matching tag are pushed. The value is a string of up to 16… |
| DlqPolicy | string | no | The dead-letter queue policy (JSON-encoded) |
| TenantRateLimitPolicy | string | no | The throttling policy (JSON-encoded) |
| StsRoleArn | string | no | The ARN of the RAM role assumed by the service. The format is acs:ram::{Alibaba Cloud account ID}:role/{RoleName}. Replace {Alibaba Cloud… |
| DmAttributes | string | no | The email push attributes. This parameter is required when PushType is set to dm. The value is in JSON format and contains the following… |
| DysmsAttributes | string | no | The SMS push attributes. This parameter is required when PushType is set to alisms. The value is in JSON format and contains the following… |
| KafkaAttributes | string | no | The Kafka push type is deprecated (JSON-encoded) |

### Cancels an existing subscription
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/unsubscribe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mns-open.ap-southeast-1.aliyuncs.com |
| TopicName | string | yes | The name of the topic |
| SubscriptionName | string | yes | The name of the subscription |

### version
`POST https://apizie.tech/v1/cloud:aliyun-mns-open/version` (byok)

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

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-mns-open/authorize-endpoint-acl" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Simple Message Queue (formerly MNS) API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-mns-open/authorize-endpoint-acl with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Alibaba Cloud Simple Message Queue (formerly MNS) API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-mns-open.

### What is the status of the Alibaba Cloud Simple Message Queue (formerly MNS) API?
Needs your own provider key (bring your own key)