ScheduledMaintenanceEventEndpoints

Resource URI

/scheduledMaintenanceEvents/{scheduledMaintenanceEventId}/endpoints

Items in curly braces represent variables.

Description

A collection of Endpoints associated with the given Scheduled Maintenance Event.]

Resource Schema

Property Characteristics
id Type string
Sub-type
Create Rule Ignored
Update Rule Required (if not in context)
Fetch Rule Implicit
Description Object identifier (External endpoint identifier).
allowMissingApiKey Type boolean
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Set to true to allow calls without API keys. This property is for the calls made to Mashery. This property requires that a special API key is created with the key value of noapikey. This key is used by Mashery to accept the API call, apply the business rules, and log requests for the endpoint.
apiKeyValueLocationKey Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Enter the API Key ID. This can either be the name field that designates the key in your API calls or, in the case of a Key Location of Path, a space delimited set of numbers designating the locations in the request path that should be recorded as the API key. The key location identifier helps Mashery to identify the key in the key source.
apiKeyValueLocations Type array
Sub-type enum
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description enum literals: request-parameters, request-path, request-body, request-header, custom
apiMethodDetectionKey Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Enter the method identifier, aka the string that uniquely identifies the incoming method to the Traffic Manager. It defines where to look for a method in a request path. The method location identifier helps Mashery to identify the method in the method source.
apiMethodDetectionLocations Type array
Sub-type enum
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description enum literals: request-parameters, request-path, request-body, request-header, custom
cache Type object
Sub-type Cache
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Cache object. Set of properties managing the cache behaviors for the Endpoint.
connectionTimeoutForSystemDomainRequest Type integer
Sub-type enum
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description enum literals: 2,5,10,20,30,45,60
connectionTimeoutForSystemDomainResponse Type integer
Sub-type enum
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description enum literals: 2,5,10,20,30,45,60,120,300,600,900,1200
cookiesDuringHttpRedirectsEnabled Type boolean
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Set to true to enable cookies during redirects. Cookies can be enabled and collected during server requests from Mashery to the client API server.
cors Type object
Sub-type Cors
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Cors object. Set of properties managing the CORS behaviors for the Endpoint.
created Type string
Sub-type datetime
Create Rule Ignored
Update Rule Ignored
Fetch Rule Implicit
Description Date/time the object was created.
customRequestAuthenticationAdapter Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Custom adapter for authentication for an endpoint
dropApiKeyFromIncomingCall Type boolean
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Drop mapi from call
forceGzipOfBackendCall Type boolean
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Force GZip Accept-Encoding on backend call
gzipPassthroughSupportEnabled Type boolean
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Set to true to enable GZIP passthrough. Traffic Manager accepts and sends GZip directives to the client API server.
headersToExcludeFromIncomingCall Type array
Sub-type string
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description HTTP Headers to Drop from Incoming Call
highSecurity Type boolean
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Set to true if calls made to this Endpoint should always be under SSL. Enable this for greater security of the API calls made against this Endpoint. NOTE: your customer area must be configured for this feature.
hostPassthroughIncludedInBackendCallHeader Type boolean
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Pass X-Mashery-Host Header in Request
inboundSslRequired Type boolean
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description value in db will be 0 for false and 1 for true
jsonpCallbackParameter Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description The parameter is used by Traffic Manager while handling the JSON responses.
jsonpCallbackParameterValue Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description The default parameter value can be set to be used by Traffic Manager to effectively handle the JSON response.
scheduledMaintenanceEvent Type object
Sub-type ScheduledMaintenanceEvent
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Scheduled Maintenance Event object.
forwardedHeaders Type array
Sub-type enum
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description enum literals: mashery-host, mashery-message-id, mashery-service-id
returnedHeaders Type array
Sub-type enum
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description enum literals: mashery-message-id, mashery-responder
methods Type array
Sub-type Method
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Methods that belong to the Endpoint.
name Type string
Sub-type
Create Rule Required
Update Rule Optional
Fetch Rule Implicit
Description Endpoint name.
numberOfHttpRedirectsToFollow Type integer
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Enter a number of HTTP redirects to follow. By default, Traffic Manager does not handle any redirects.
outboundRequestTargetPath Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Request path
outboundRequestTargetQueryParameters Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Outbound query parameters
outboundTransportProtocol Type string
Sub-type enum
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description enum literals: use-inbound, http, https
processor Type object
Sub-type Processor
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Processor object. This is a set of properties uses to manage customizations to API call traffic management.
publicDomains Type array
Sub-type Domain
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description The public hostname (domain name) is used by a developer application or widget to make an API call.
requestAuthenticationType Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Authentication type for the endpoint
requestPathAlias Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Request path
requestProtocol Type string
Sub-type enum
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description enum literals: rest,soap,xml-rpc,json-rpc,other
oauthGrantTypes Type array
Sub-type enum
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description enum literals: authorization-code, implicit, password, client-credentials
stringsToTrimFromApiKey Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Strings to be trimmed from the API Key before the call is passed to your API.
supportedHttpMethods Type array
Sub-type enum
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description enum literals: get, post, put, delete, head, options, patch
systemDomainAuthentication Type object
Sub-type SystemDomainAuthentication
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description SystemDomainAuthentication object.
systemDomains Type array
Sub-type Domain
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description The domain name of the client API server. Mashery performs call logging, and applies the business rules before sending an API call to this domain.
trafficManagerDomain Type string
Sub-type
Create Rule Required
Update Rule Optional
Fetch Rule Explicit
Description The Traffic Manager internal hostname (domain name) to which the requested public hostname is CNAMED. You must consult Mashery before creating new Mashery internal hostnames.
updated Type string
Sub-type datetime
Create Rule Ignored
Update Rule Ignored
Fetch Rule Implicit
Description Date/time the object was last updated.
useSystemDomainCredentials Type boolean
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description To suit to the client server's requirement, Mashery can swap the API credentials such as API keys and send the swapped Mashery credentials to the client API server.
systemDomainCredentialKey Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Key to use when making call to the client API server.
systemDomainCredentialSecret Type string
Sub-type
Create Rule Optional
Update Rule Optional
Fetch Rule Explicit
Description Secret to use when making call to the client API server.

fetch [GET]

Retrieves collection of all Scheduled Maintenance Events objects belonging to the given Area

Parameters

Parameter Required Type Description
scheduledMaintenanceEventId true string The Scheduled Maintenance Event identifier
fields false string Comma-separated list of property paths to include in response. Each property path is a dot-separated list of object property names. fields=<property\[.property...\]>\[,...\]\[&fields=...\]
filter false string Colon-separated name/value pair specifying the name of property whose value must contain the given value (as a substring). Results may also be filtered by nested collections' properties by specifying a dot-separated property path. filter=<property\[.property...\]>:<value>\[&filter=...\]
sort false string Comma-separated list of properties to sort by. Only root-level properties are supported. Each property name may be optionally followed by :asc or :desc to specify sort direction (defaults to asc). sort=<property\[:(asc\|desc)\]>\[,...\]\[&sort=...\]
limit false int Number of objects to return in the result. Defaults to 100.
offset false int 0-based index of first object in the list to return. Defaults to 0.

Returns

Success

Array of Scheduled Maintenance Events for the Area If fields request parameter is not included, only those fields with "Fetch Rule" equal to "Implicit" will be returned. Otherwise, the fields contained in the URL parameter will be included in the response.

Failure

Array of validation responses

Examples

Request

curl -k 'https://api.mashery.com/v3/rest/scheduledMaintenanceEvents/b1785a64-8184-48d1-add1-d2164ebe4a01/endpoints' -H "Authorization: Bearer <insert your token here>" -H "Content-Type:application/json" 

Response

[
    {
        "requestProtocol": "rest",
        "trafficManagerDomain": "chennaibizz.com",
        "supportedHttpMethods": "patch",
        "numberOfHttpRedirectsToFollow": 95,
        "requestAuthenticationType": "morbi",
        "requestPathAlias": "in faucibus",
        "useSystemDomainCredentials": false,
        "outboundRequestTargetPath": "tincidunt ante vel",
        "apiMethodDetectionLocations": "request-parameters",
        "id": "59d0fab7-068b-4fa9-b216-627ccb1b6221",
        "apiMethodDetectionKey": "semper est quam",
        "cookiesDuringHttpRedirectsEnabled": true,
        "stringsToTrimFromApiKey": "ultrices mattis",
        "forwardedHeaders": "mashery-service-id",
        "updated": "2013-11-22T04:07:57.000+0000",
        "created": "2013-08-19T03:21:41.000+0000",
        "gzipPassthroughSupportEnabled": true,
        "inboundSslRequired": false,
        "name": "lectus pellentesque eget nunc",
        "apiKeyValueLocations": "custom",
        "customRequestAuthenticationAdapter": "ac",
        "systemDomainCredentialSecret": "libero nam",
        "oauthGrantTypes": "password",
        "allowMissingApiKey": false,
        "dropApiKeyFromIncomingCall": true,
        "outboundRequestTargetQueryParameters": "accumsan",
        "systemDomainCredentialKey": "ac nibh fusce",
        "highSecurity": true,
        "forceGzipOfBackendCall": true,
        "connectionTimeoutForSystemDomainResponse": 73,
        "apiKeyValueLocationKey": "ac",
        "jsonpCallbackParameterValue": "quis turpis eget",
        "jsonpCallbackParameter": "aliquam",
        "connectionTimeoutForSystemDomainRequest": 27,
        "returnedHeaders": "mashery-message-id",
        "hostPassthroughIncludedInBackendCallHeader": false,
        "outboundTransportProtocol": "http"
    }
]

Request

curl -k 'https://api.mashery.com/v3/rest/scheduledMaintenanceEvents/b1785a64-8184-48d1-add1-d2164ebe4a01/endpoints' -H "Authorization: Bearer <insert your token here>" -H "Content-Type:application/json" 

Response

[
    {
        "id": "c33baa56-c636-4c9a-bc72-3e84179314be",
        "created": "2014-01-24T19:14:39.000+0000",
        "updated": "2013-08-19T00:51:14.000+0000",
        "name": "urna"
    }
]

fetch all [GET]

Retrieves the identified Scheduled Maintenance Event.

Parameters

Parameter Required Type Description
scheduledMaintenanceEventId true string The Scheduled Maintenance Event identifier
scheduledMaintenanceEventEndpointId true string The Scheduled Maintenance Event Endpoint identifier
fields false string Comma-separated list of property paths to include in response. Each property path is a dot-separated list of object property names. fields=<property\[.property...\]>\[,...\]\[&fields=...\]
filter false string Colon-separated name/value pair specifying the name of property whose value must contain the given value (as a substring). Results may also be filtered by nested collections' properties by specifying a dot-separated property path. filter=<property\[.property...\]>:<value>\[&filter=...\]
sort false string Comma-separated list of properties to sort by. Only root-level properties are supported. Each property name may be optionally followed by :asc or :desc to specify sort direction (defaults to asc). sort=<property\[:(asc\|desc)\]>\[,...\]\[&sort=...\]
limit false int Number of objects to return in the result. Defaults to 100.
offset false int 0-based index of first object in the list to return. Defaults to 0.
indent false boolean When set to true, responses are indented for better readability.

Returns

Success

The identified Scheduled Maintenance Event If fields request parameter is not included, only those fields with "Fetch Rule" equal to "Implicit" will be returned. Otherwise, the fields contained in the URL parameter will be included in the response.

Failure

Array of validation responses

Examples

Request

curl -k 'https://api.mashery.com/v3/rest/scheduledMaintenanceEvents/b1785a64-8184-48d1-add1-d2164ebe4a01/endpoints/{scheduledMaintenanceEventEndpointId}' -H "Authorization: Bearer <insert your token here>" -H "Content-Type:application/json" 

Response

[
    {
        "requestProtocol": "other",
        "trafficManagerDomain": "argim.org",
        "supportedHttpMethods": "get",
        "numberOfHttpRedirectsToFollow": 84,
        "requestAuthenticationType": "sapien",
        "requestPathAlias": "tellus nisi",
        "useSystemDomainCredentials": false,
        "outboundRequestTargetPath": "quis",
        "apiMethodDetectionLocations": "request-path",
        "id": "064d0725-62cf-4ac1-8728-61980242593a",
        "apiMethodDetectionKey": "sagittis",
        "cookiesDuringHttpRedirectsEnabled": true,
        "stringsToTrimFromApiKey": "nullam porttitor",
        "forwardedHeaders": "mashery-host",
        "updated": "2014-05-13T00:28:51.000+0000",
        "created": "2013-12-05T02:09:07.000+0000",
        "gzipPassthroughSupportEnabled": true,
        "inboundSslRequired": false,
        "name": "nibh fusce lacus purus",
        "apiKeyValueLocations": "request-path",
        "customRequestAuthenticationAdapter": "eu est congue",
        "systemDomainCredentialSecret": "quis augue luctus",
        "oauthGrantTypes": "client-credentials",
        "allowMissingApiKey": false,
        "dropApiKeyFromIncomingCall": true,
        "outboundRequestTargetQueryParameters": "etiam faucibus cursus",
        "systemDomainCredentialKey": "leo pellentesque",
        "highSecurity": false,
        "forceGzipOfBackendCall": false,
        "connectionTimeoutForSystemDomainResponse": 16,
        "apiKeyValueLocationKey": "cras non velit",
        "jsonpCallbackParameterValue": "rhoncus sed vestibulum sit",
        "jsonpCallbackParameter": "in lacus curabitur",
        "connectionTimeoutForSystemDomainRequest": 82,
        "returnedHeaders": "mashery-message-id",
        "hostPassthroughIncludedInBackendCallHeader": true,
        "outboundTransportProtocol": "use-inbound"
    }
]

Request

curl -k 'https://api.mashery.com/v3/rest/scheduledMaintenanceEvents/b1785a64-8184-48d1-add1-d2164ebe4a01/endpoints/{scheduledMaintenanceEventEndpointId}' -H "Authorization: Bearer <insert your token here>" -H "Content-Type:application/json" 

Response

[
    {
        "id": "4a5111a0-4c16-4c56-87eb-1c335f2a57d1",
        "created": "2014-06-26T10:58:01.000+0000",
        "updated": "2014-07-06T02:35:23.000+0000",
        "name": "habitasse platea"
    }
]

create [POST]

Creates a new Scheduled Maintenance Events in the given Area.

Parameters

Parameter Required Type Description
scheduledMaintenanceEventId true string The Scheduled Maintenance Event identifier
scheduledMaintenanceEventEndpoint true object Scheduled Maintenance Event Endpoint object

Returns

Success

Scheduled Maintenance Event Endpoint as created If fields request parameter is not included, only those fields with "Fetch Rule" equal to "Implicit" will be returned. Otherwise, the fields contained in the URL parameter will be included in the response.

Failure

Array of validation responses

Examples

Request

curl -k 'https://api.mashery.com/v3/rest/scheduledMaintenanceEvents/b1785a64-8184-48d1-add1-d2164ebe4a01/endpoints' -H "Authorization: Bearer <insert your token here>" -H "Content-Type:application/json" --request POST --data '{"trafficManagerDomain":"messehotel-frankfurt-oder.de","requestProtocol":"xml-rpc","supportedHttpMethods":"options","numberOfHttpRedirectsToFollow":54,"useSystemDomainCredentials":false,"requestPathAlias":"consequat nulla","requestAuthenticationType":"sem duis aliquam","apiMethodDetectionLocations":"request-parameters","outboundRequestTargetPath":"augue quam","apiMethodDetectionKey":"odio condimentum id luctus","id":"5ec00b6a-e7ff-44b7-ab37-101b876555c2","stringsToTrimFromApiKey":"erat","cookiesDuringHttpRedirectsEnabled":true,"forwardedHeaders":"mashery-message-id","updated":"2014-05-21T11:38:01.000+0000","created":"2014-06-09T16:14:03.000+0000","gzipPassthroughSupportEnabled":false,"inboundSslRequired":true,"name":"vitae mattis nibh ligula","apiKeyValueLocations":"custom","customRequestAuthenticationAdapter":"facilisi","systemDomainCredentialSecret":"nisl","oauthGrantTypes":"implicit","allowMissingApiKey":false,"dropApiKeyFromIncomingCall":false,"systemDomainCredentialKey":"nisi nam ultrices libero","outboundRequestTargetQueryParameters":"ut","highSecurity":true,"forceGzipOfBackendCall":false,"connectionTimeoutForSystemDomainResponse":55,"apiKeyValueLocationKey":"aliquam augue quam","connectionTimeoutForSystemDomainRequest":76,"jsonpCallbackParameter":"nunc","jsonpCallbackParameterValue":"vestibulum sagittis sapien cum","returnedHeaders":"mashery-message-id","hostPassthroughIncludedInBackendCallHeader":true,"outboundTransportProtocol":"use-inbound"}

Response

[
    {
        "requestProtocol": "rest",
        "trafficManagerDomain": "promatching.com",
        "supportedHttpMethods": "put",
        "numberOfHttpRedirectsToFollow": 47,
        "requestAuthenticationType": "ante",
        "requestPathAlias": "consectetuer",
        "useSystemDomainCredentials": false,
        "outboundRequestTargetPath": "id sapien in sapien",
        "apiMethodDetectionLocations": "request-header",
        "id": "56a23111-d941-40b7-b4e2-24f4b72b0faa",
        "apiMethodDetectionKey": "nullam porttitor lacus",
        "cookiesDuringHttpRedirectsEnabled": false,
        "stringsToTrimFromApiKey": "nulla pede ullamcorper augue",
        "forwardedHeaders": "mashery-host",
        "updated": "2013-08-15T11:58:08.000+0000",
        "created": "2014-02-08T18:27:04.000+0000",
        "gzipPassthroughSupportEnabled": true,
        "inboundSslRequired": false,
        "name": "felis donec semper",
        "apiKeyValueLocations": "request-header",
        "customRequestAuthenticationAdapter": "amet sapien",
        "systemDomainCredentialSecret": "luctus et",
        "oauthGrantTypes": "implicit",
        "allowMissingApiKey": true,
        "dropApiKeyFromIncomingCall": true,
        "outboundRequestTargetQueryParameters": "nulla eget eros",
        "systemDomainCredentialKey": "turpis donec posuere",
        "highSecurity": false,
        "forceGzipOfBackendCall": false,
        "connectionTimeoutForSystemDomainResponse": 82,
        "apiKeyValueLocationKey": "vestibulum proin eu mi",
        "jsonpCallbackParameterValue": "ipsum primis in faucibus",
        "jsonpCallbackParameter": "sem mauris",
        "connectionTimeoutForSystemDomainRequest": 57,
        "returnedHeaders": "mashery-message-id",
        "hostPassthroughIncludedInBackendCallHeader": true,
        "outboundTransportProtocol": "https"
    }
]

Request

curl -k 'https://api.mashery.com/v3/rest/scheduledMaintenanceEvents/b1785a64-8184-48d1-add1-d2164ebe4a01/endpoints' -H "Authorization: Bearer <insert your token here>" -H "Content-Type:application/json" --request POST --data '{"id":"4f2f6444-909e-4bc3-8f40-83bb2db7a753","updated":"2014-05-25T19:40:14.000+0000","created":"2014-07-16T07:05:47.000+0000","name":"suscipit a feugiat"}

Response

[
    {
        "id": "73e60320-8822-434d-b920-6c3203410d11",
        "created": "2014-04-28T12:13:16.000+0000",
        "updated": "2013-10-06T23:06:32.000+0000",
        "name": "nunc purus phasellus"
    }
]

delete [DELETE]

Deletes the identified Scheduled Maintenance Event.

Parameters

Parameter Required Type Description
scheduledMaintenanceEventId true string The Scheduled Maintenance Event identifier
scheduledMaintenanceEventEndpointId true string The Scheduled Maintenance Event Endpoint identifier

Returns

Success

Empty response

Failure

Array of validation responses

Examples

Request

curl -k 'https://api.mashery.com/v3/rest/scheduledMaintenanceEvents/b1785a64-8184-48d1-add1-d2164ebe4a01/endpoints/{scheduledMaintenanceEventEndpointId}' -H "Authorization: Bearer <insert your token here>" -H "Content-Type:application/json" --request DELETE

Response

[
    ""
]

Request

curl -k 'https://api.mashery.com/v3/rest/scheduledMaintenanceEvents/b1785a64-8184-48d1-add1-d2164ebe4a01/endpoints/{scheduledMaintenanceEventEndpointId}' -H "Authorization: Bearer <insert your token here>" -H "Content-Type:application/json" --request DELETE

Response

[
    ""
]

Docs Navigation