Database.com Metadata API Developer's Guide - Salesforce.com

Metadata TypesRoleFieldsFielddescriptiondisableProtocolSecurityField TypestringbooleanDescriptionThe description explaining what this remote site setting isused for.Required. Indicates whether code within Database.com canaccess the remote site regardless of whether the user'sconnection is over HTTP or HTTPS (true) or not(false). When true, code within Database.com can passdata from an HTTPS session to an HTTP session, and viceversa.Warning: Only set to true if you understand thesecurity implications.fullNameisActiveurlstringbooleanstringThe name can only contain characters, letters, and theunderscore (_) character, must start with a letter, and cannotend with an underscore or contain two consecutiveunderscore characters.Inherited from the Metadata component, this field is notdefined in the WSDL for this component. It must bespecified when creating, updating, or deleting. Seecreate() to see an example of this field specified for acall.Required. Indicates if the remote site setting is active (true)or not (false).Required. The URL for the remote site.Declarative Metadata Sample DefinitionA sample XML definition of a remote site setting is shown below.Used for Apex callout to mapping web servicefalsetruehttps://www.maptestsite.net/mapping1RoleRepresents a role in your organization.Declarative Metadata File Suffix and Directory LocationThe file suffix for role components is .role and components are stored in the roles directory of the corresponding packagedirectory.VersionRole components are available in API version 24.0 and later.143