ApiAccessRuleType

Contains the definition of a rule that governs the number of times your application can access the eBay API (invoke a call) on an hourly, daily, or periodic basis.

Types that use ApiAccessRuleType:

Call that uses one or more fields of ApiAccessRuleType:

Fields

CallName ( string )
CountsTowardAggregate ( boolean )
DailyHardLimit ( long )
DailySoftLimit ( long )
DailyUsage ( long )
HourlyHardLimit ( long )
HourlySoftLimit ( long )
HourlyUsage ( long )
ModTime ( dateTime )
Period ( int )
PeriodicHardLimit ( long )
PeriodicSoftLimit ( long )
PeriodicStartDate ( dateTime )
PeriodicUsage ( long )
RuleCurrentStatus ( AccessRuleCurrentStatusCodeType )
RuleStatus ( AccessRuleStatusCodeType )

CallName ( string ) [1]
The name of the call that has an access rule. Can be a call name (e.g., AddItem), ApplicationAggregate (returns totals for all calls), PasswordAuthenticationLimiter (dummy call), or NonUTF8UsageLimiter.
See the Field Index to learn which calls use CallName.

CountsTowardAggregate ( boolean ) [1]
Whether use of this call counts toward the application's aggregate limit for all calls.
See the Field Index to learn which calls use CountsTowardAggregate.

DailyHardLimit ( long ) [1]
The number of calls per day that your application can make to this call before being refused. The day starts at midnight, 00:00:00 PST (not GMT).
See the Field Index to learn which calls use DailyHardLimit.

DailySoftLimit ( long ) [1]
The number of calls per day that your application can make to this call before you receive a warning. The day starts at midnight, 00:00:00 PST.
See the Field Index to learn which calls use DailySoftLimit.

DailyUsage ( long ) [1]
The number of times your application has used this call today.
See the Field Index to learn which calls use DailyUsage.

HourlyHardLimit ( long ) [1]
The number of calls that your application can make per hour to this call before being refused. Each count begins on the hour (e.g. 1:00:00).
See the Field Index to learn which calls use HourlyHardLimit.

HourlySoftLimit ( long ) [1]
The number of calls that your application can make to this call per hour before you receive a warning. Each count begins on the hour (e.g. 1:00:00).
See the Field Index to learn which calls use HourlySoftLimit.

HourlyUsage ( long ) [1]
The number of times your application has executed this call during this hour.
See the Field Index to learn which calls use HourlyUsage.

ModTime ( dateTime ) [1]
The date and time this access rule was last modified by eBay.
See the Field Index to learn which calls use ModTime.

Period ( int ) [1]
The length of time before your application's perodic usage counter restarts for this call. If the number of calls you make exceeds the periodic hard limit before the current period ends, further calls will be refused until the next period starts. Possible values: -1 (Periodic limit not enforced, could be any negative integer), 0 (Calendar month), 30 (Number of days, could be any positive integer). If the period is based on the calendar month, the usage counters restart on the same day of every month, regardless of the number of days in the month.
See the Field Index to learn which calls use Period.

PeriodicHardLimit ( long ) [1]
Number of calls per period that your application may make before a call is refused, if the periodic limit is enforced. The length of the period is specified in Period.
See the Field Index to learn which calls use PeriodicHardLimit.

PeriodicSoftLimit ( long ) [1]
Number of calls per period that your application may make before you receive a warning, if the periodic limit is enforced. The length of the period is specified in Period.
See the Field Index to learn which calls use PeriodicSoftLimit.

PeriodicStartDate ( dateTime ) [0..1]
The time (in GMT) when this access rule's period started. The period starts at midnight Pacific time. For example, if the period begins on June 29 in 2005 when California is on Pacific Daylight Time, the GMT value returned would be 2005-06-29T07:00:00.000Z If the period begins on December 29 in 2005 when California is on Pacific Standard Time, the GMT value returned would be 2005-12-29T08:00:00.000Z. Only returned when the eBay Developers Program has configured the start date for the access rule. The start date can vary per application and per call name (i.e., per access rule).
See the Field Index to learn which calls use PeriodicStartDate.

PeriodicUsage ( long ) [1]
Number of calls that your application has already made this period. Returns 0 if the periodic access rule has not been configured for the application. The length of the period is specified in Period. The start date of the period is specified in PeriodicStartDate.
See the Field Index to learn which calls use PeriodicUsage.

RuleCurrentStatus ( see AccessRuleCurrentStatusCodeType for possible values ) [1]
Your application's current status for this rule, including whether the rule is set for your application and whether the application has exceeded its daily or hourly limit.
See the Field Index to learn which calls use RuleCurrentStatus.

RuleStatus ( see AccessRuleStatusCodeType for possible values ) [1]
The status of the access rule, including whether the rule is turned on or off and whether the application is currently blocked from using this call. No effect if RuleCurrentStatus is set to NotSet.
See the Field Index to learn which calls use RuleStatus.

Copyright © 2005–2013 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.