getRangeSlotCapacity - Amazon SP API

Provides capacity slots in a format similar to availability records.

Usage Plan:

Rate (requests per second)	Burst
5	20

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Request

Path Params

resourceId

string

required

Resource Identifier.

>= 1 characters<= 100 characters

Query Params

marketplaceIds

array[string]

required

An identifier for the marketplace in which the resource operates.

<= 1 items

nextPageToken

string

optional

Next page token returned in the response of your previous request.

Body Params application/json

Request schema for the `getRangeSlotCapacity` operation. This schema is used to define the time range and capacity types that are being queried.

capacityTypes

array[string]

optional

An array of capacity types which are being requested. Default value is [SCHEDULED_CAPACITY].

Allowed values:

SCHEDULED_CAPACITYAVAILABLE_CAPACITYENCUMBERED_CAPACITYRESERVED_CAPACITY

startDateTime

string <date-time>

required

Start date time from which the capacity slots are being requested in ISO 8601 format.

endDateTime

string <date-time>

required

End date time up to which the capacity slots are being requested in ISO 8601 format.

Example

{
    "capacityTypes": [
        "SCHEDULED_CAPACITY"
    ],
    "startDateTime": "2019-08-24T14:15:22Z",
    "endDateTime": "2019-08-24T14:15:22Z"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Success response.

Headers

x-amzn-RateLimit-Limit

string

optional

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

optional

Unique request reference identifier.

Body

Response schema for the `getRangeSlotCapacity` operation.

resourceId

string

optional

Resource Identifier.

capacities

array[object (RangeCapacity) {2}]

optional

Array of range capacities where each entry is for a specific capacity type.

capacityType

enum<string>

optional

Type of capacity

Allowed values:

SCHEDULED_CAPACITYAVAILABLE_CAPACITYENCUMBERED_CAPACITYRESERVED_CAPACITY

slots

array[object (RangeSlot) {3}]

optional

Array of capacity slots in range slot format.

nextPageToken

string

optional

Next page token, if there are more pages.

Example

{
    "resourceId": "string",
    "capacities": [
        {
            "capacityType": "SCHEDULED_CAPACITY",
            "slots": [
                {
                    "startDateTime": "2019-08-24T14:15:22Z",
                    "endDateTime": "2019-08-24T14:15:22Z",
                    "capacity": 0
                }
            ]
        }
    ],
    "nextPageToken": "string"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠413413

🟠415415

🟠429429

🔴500Server Error

🔴503Service Unavailable