Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
Removes an existing destination from the list of registered destinations.
The DeregisterDestination operation specifies a location where you no longer want to receive notifications. Before you can call this operation, you must first delete the Subscription that is being delivered to the Destination by calling the DeleteSubscription operation.
If you attempt to call this operation with a Destination that you did not previously register, the service returns an error.
After calling this operation, you will have to call the RegisterDestination operation if you want to receive notifications at the Destination again.
This operation is available in all marketplaces except Mexico.
Maximum request quota | Restore rate | Hourly request quota |
---|---|---|
25 requests | Two requests every second | 7200 requests per hour |
For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.
Name | Description | Required | Valid values |
---|---|---|---|
MarketplaceId | The unique identifier for the marketplace. | Yes | Any valid MarketplaceId that you are registered in. For a list of MarketplaceId
values, see Amazon MWS endpoints and MarketplaceId values in the Amazon MWS Developer Guide. Type: xs:string |
Destination | The Destination where you no longer want to receive notifications. | Yes | Any valid Destination that you previously registered by
calling the RegisterDestination operation. Type: Destination |
The DeregisterDestination operation only returns the common response elements.
For information about standard request requirements, see Required request parameters.
POST /Subscriptions/2013-07-01 HTTP/1.1 Content-Type: x-www-form-urlencoded Host: mws.amazonservices.com User-Agent: <Your User Agent Header> AWSAccessKeyId=AKIAEEXAMPLENGQCJLSA &Action=DeregisterDestination &Destination.AttributeList.member.1.Key=sqsQueueUrl &Destination.AttributeList.member.1.Value= https%3A%2F%2Fsqs.us-east-1.amazonaws.com%2F51471EXAMPLE%2Fmws_notifications &Destination.DeliveryChannel=SQS &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &SellerId=A135KEXAMPLE56 &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2013-07-25T16%3A21%3A03Z &Version=2013-07-01 &Signature=H1%2FEXAMPLEEnwyhzIEk3wR2AiasJjj7hVeherC3r0Hk%3D
For information about standard response formatting, see Response format.
<RegisterDestinationResponse xmlns="http://mws.amazonservices.com/schema/Subscriptions/2013-07-01"> <RegisterDestinationResult/> <ResponseMetadata> <RequestId>b120e610-9cf0-48d7-b615-ca869EXAMPLE</RequestId> </ResponseMetadata> </RegisterDestinationResponse>