| 1 | <?xml version="1.0"?> |
|---|
| 2 | <xsd:schema targetNamespace="http://www.isi.edu/faber/fedd_types" |
|---|
| 3 | xmlns:tns="http://www.isi.edu/faber/fedd_types" |
|---|
| 4 | xmlns:topdl="http://www.isi.edu/faber/topdl" |
|---|
| 5 | xmlns:xsd="http://www.w3.org/2001/XMLSchema" |
|---|
| 6 | xmlns="http://www.w3.org/2000/10/XMLSchema"> |
|---|
| 7 | |
|---|
| 8 | <xsd:complexType name="IDType"> |
|---|
| 9 | <xsd:annotation> |
|---|
| 10 | <xsd:documentation> |
|---|
| 11 | An ID is an identifier for a principal, service, or object. This type |
|---|
| 12 | is currently polymorphic o allow different implementations of type, |
|---|
| 13 | though running code primarily uses localnames and fedids. |
|---|
| 14 | </xsd:documentation> |
|---|
| 15 | </xsd:annotation> |
|---|
| 16 | <xsd:choice> |
|---|
| 17 | <xsd:element name="uuid" type="xsd:base64Binary"/> |
|---|
| 18 | <xsd:element name="fedid" type="xsd:base64Binary"/> |
|---|
| 19 | <xsd:element name="uri" type="xsd:string"/> |
|---|
| 20 | <xsd:element name="localname" type="xsd:string"/> |
|---|
| 21 | <xsd:element name="kerberosUsername" type="xsd:string"/> |
|---|
| 22 | </xsd:choice> |
|---|
| 23 | </xsd:complexType> |
|---|
| 24 | |
|---|
| 25 | <xsd:complexType name="nodeType"> |
|---|
| 26 | <xsd:annotation> |
|---|
| 27 | <xsd:documentation> |
|---|
| 28 | A node from an Emulab. It may have 0 or more images or hardware |
|---|
| 29 | types associated with it. As this description is used for |
|---|
| 30 | acquiring access to the testbed in question, multiple images or |
|---|
| 31 | types are considered options. Specifying multiple image names |
|---|
| 32 | indicates that the requester is looking for support for any of |
|---|
| 33 | them. |
|---|
| 34 | </xsd:documentation> |
|---|
| 35 | </xsd:annotation> |
|---|
| 36 | <xsd:sequence> |
|---|
| 37 | <xsd:element name="image" type="xsd:string" minOccurs="0" |
|---|
| 38 | maxOccurs="unbounded"/> |
|---|
| 39 | <xsd:element name="hardware" type="xsd:string" minOccurs="0" |
|---|
| 40 | maxOccurs="unbounded"/> |
|---|
| 41 | </xsd:sequence> |
|---|
| 42 | <xsd:attribute name="count" type="xsd:int" use="optional"/> |
|---|
| 43 | </xsd:complexType> |
|---|
| 44 | |
|---|
| 45 | <xsd:simpleType name="kindType"> |
|---|
| 46 | <xsd:annotation> |
|---|
| 47 | <xsd:documentation> |
|---|
| 48 | An indication of how requested networking capacity is measured. |
|---|
| 49 | This will undoubtably expand. |
|---|
| 50 | </xsd:documentation> |
|---|
| 51 | </xsd:annotation> |
|---|
| 52 | <xsd:restriction base="xsd:string"> |
|---|
| 53 | <xsd:enumeration value="max"/> |
|---|
| 54 | <xsd:enumeration value="average"/> |
|---|
| 55 | </xsd:restriction> |
|---|
| 56 | </xsd:simpleType> |
|---|
| 57 | |
|---|
| 58 | <xsd:simpleType name="statusType"> |
|---|
| 59 | <xsd:annotation> |
|---|
| 60 | <xsd:documentation> |
|---|
| 61 | The current state of the experiment. |
|---|
| 62 | </xsd:documentation> |
|---|
| 63 | </xsd:annotation> |
|---|
| 64 | <xsd:restriction base="xsd:string"> |
|---|
| 65 | <xsd:enumeration value="active"/> |
|---|
| 66 | <xsd:enumeration value="starting"/> |
|---|
| 67 | <xsd:enumeration value="terminating"/> |
|---|
| 68 | <xsd:enumeration value="failed"/> |
|---|
| 69 | </xsd:restriction> |
|---|
| 70 | </xsd:simpleType> |
|---|
| 71 | |
|---|
| 72 | <xsd:complexType name="capacityType"> |
|---|
| 73 | <xsd:annotation> |
|---|
| 74 | <xsd:documentation> |
|---|
| 75 | A strawman network capacity description for access negotiation. |
|---|
| 76 | This will come to include more and more interesting parameters. |
|---|
| 77 | </xsd:documentation> |
|---|
| 78 | </xsd:annotation> |
|---|
| 79 | <xsd:sequence> |
|---|
| 80 | <xsd:element name="rate" type="xsd:double"/> |
|---|
| 81 | <xsd:element name="kind" type="tns:kindType"/> |
|---|
| 82 | </xsd:sequence> |
|---|
| 83 | </xsd:complexType> |
|---|
| 84 | |
|---|
| 85 | <xsd:complexType name="accessType"> |
|---|
| 86 | <xsd:annotation> |
|---|
| 87 | <xsd:documentation> |
|---|
| 88 | This captures an access credential that will be used to access |
|---|
| 89 | resources. These are certificates or public keys. The type is |
|---|
| 90 | used to designate the key to which access should be bound, or on |
|---|
| 91 | a reply has been bound. Dynamic credentials where new keys have |
|---|
| 92 | been created may also be passed in this kind of field. |
|---|
| 93 | </xsd:documentation> |
|---|
| 94 | </xsd:annotation> |
|---|
| 95 | <xsd:choice> |
|---|
| 96 | <xsd:element name="X509" type="xsd:base64Binary"/> |
|---|
| 97 | <xsd:element name="sshPubkey" type="xsd:base64Binary"/> |
|---|
| 98 | <xsd:element name="pgpPubkey" type="xsd:base64Binary"/> |
|---|
| 99 | </xsd:choice> |
|---|
| 100 | </xsd:complexType> |
|---|
| 101 | |
|---|
| 102 | <xsd:simpleType name="userRole"> |
|---|
| 103 | <xsd:annotation> |
|---|
| 104 | <xsd:documentation> |
|---|
| 105 | This defines the role the user/account is playing in the |
|---|
| 106 | federated experiment. An account being accessed by the |
|---|
| 107 | federation system to create the experiment is in the |
|---|
| 108 | experimentCreation role and the accounts that experimenters will |
|---|
| 109 | use to access local testbed services (e.g., rebooting a local |
|---|
| 110 | node) are serviceAccess roles. |
|---|
| 111 | </xsd:documentation> |
|---|
| 112 | </xsd:annotation> |
|---|
| 113 | <xsd:restriction base="xsd:string"> |
|---|
| 114 | <xsd:enumeration value="serviceAccess"/> |
|---|
| 115 | <xsd:enumeration value="experimentCreation"/> |
|---|
| 116 | </xsd:restriction> |
|---|
| 117 | </xsd:simpleType> |
|---|
| 118 | |
|---|
| 119 | |
|---|
| 120 | <xsd:complexType name="userType"> |
|---|
| 121 | <xsd:annotation> |
|---|
| 122 | <xsd:documentation> |
|---|
| 123 | The definition of a user principal. It includes the |
|---|
| 124 | identification of the user as an ID type, the access credential(s) |
|---|
| 125 | that the user will use, and the role of the user, if any. |
|---|
| 126 | Multiple access keys may be used, and it is also possible for |
|---|
| 127 | the user to be anonymous. Though it is possible to specify a |
|---|
| 128 | user without ID, access, or role, it is difficult to imagine |
|---|
| 129 | such a user being useful. |
|---|
| 130 | </xsd:documentation> |
|---|
| 131 | </xsd:annotation> |
|---|
| 132 | <xsd:sequence> |
|---|
| 133 | <xsd:element name="userID" type="tns:IDType" minOccurs="0" |
|---|
| 134 | maxOccurs="1"/> |
|---|
| 135 | <xsd:element name="access" type="tns:accessType" minOccurs="0" |
|---|
| 136 | maxOccurs="unbounded"/> |
|---|
| 137 | <xsd:element name="role" type="tns:userRole" minOccurs="0" maxOccurs="1"/> |
|---|
| 138 | </xsd:sequence> |
|---|
| 139 | </xsd:complexType> |
|---|
| 140 | |
|---|
| 141 | <xsd:complexType name="fedAttrType"> |
|---|
| 142 | <xsd:annotation> |
|---|
| 143 | <xsd:documentation> |
|---|
| 144 | A general attribute/value pair for passing federation parameters and |
|---|
| 145 | preferences. Anything encodable in XML is allowed. This is a |
|---|
| 146 | point for customization and extension. |
|---|
| 147 | </xsd:documentation> |
|---|
| 148 | </xsd:annotation> |
|---|
| 149 | <xsd:sequence> |
|---|
| 150 | <xsd:element name="attribute" type="xsd:string"/> |
|---|
| 151 | <xsd:element name="value" type="xsd:string"/> |
|---|
| 152 | </xsd:sequence> |
|---|
| 153 | </xsd:complexType> |
|---|
| 154 | |
|---|
| 155 | |
|---|
| 156 | <xsd:complexType name="resourcesType"> |
|---|
| 157 | <xsd:annotation> |
|---|
| 158 | <xsd:documentation> |
|---|
| 159 | The estimate of resources a requester is looking for, or the |
|---|
| 160 | response of a testbed indicating what it can provide. This is |
|---|
| 161 | something of a placeholder for a full resource specification, |
|---|
| 162 | and alternative encodings are likely to be imported. |
|---|
| 163 | </xsd:documentation> |
|---|
| 164 | </xsd:annotation> |
|---|
| 165 | <xsd:sequence> |
|---|
| 166 | <xsd:element name="node" type="tns:nodeType" minOccurs="0" |
|---|
| 167 | maxOccurs="unbounded" /> |
|---|
| 168 | <xsd:element name="capacity" type="tns:capacityType" minOccurs="0" |
|---|
| 169 | maxOccurs="unbounded"/> |
|---|
| 170 | </xsd:sequence> |
|---|
| 171 | </xsd:complexType> |
|---|
| 172 | |
|---|
| 173 | <xsd:complexType name="mapType"> |
|---|
| 174 | <xsd:annotation> |
|---|
| 175 | <xsd:documentation> |
|---|
| 176 | Explicit translation of testbed attribute in a federated experiment |
|---|
| 177 | description to the URI at which the controlling federation |
|---|
| 178 | system can be reached. Used in a creation request. |
|---|
| 179 | |
|---|
| 180 | This type allows tools to encode experiments in familiar local |
|---|
| 181 | names for experimenters while providing remote federation |
|---|
| 182 | systems the information to map the local name into a service |
|---|
| 183 | location. |
|---|
| 184 | </xsd:documentation> |
|---|
| 185 | </xsd:annotation> |
|---|
| 186 | <xsd:sequence> |
|---|
| 187 | <xsd:element name="testbed" type="tns:IDType"/> |
|---|
| 188 | <xsd:element name="uri" type="xsd:string"/> |
|---|
| 189 | </xsd:sequence> |
|---|
| 190 | </xsd:complexType> |
|---|
| 191 | |
|---|
| 192 | |
|---|
| 193 | <xsd:complexType name="projectType"> |
|---|
| 194 | <xsd:annotation> |
|---|
| 195 | <xsd:documentation> |
|---|
| 196 | A description of the project used to access a testbed. Includes |
|---|
| 197 | the testbed being accessed, the project name (often a local |
|---|
| 198 | name, scoped by the testbed), and any users who have been |
|---|
| 199 | granted access or for whom access is being requested. |
|---|
| 200 | </xsd:documentation> |
|---|
| 201 | </xsd:annotation> |
|---|
| 202 | <xsd:sequence> |
|---|
| 203 | <xsd:element name="testbed" type="tns:IDType" minOccurs="0" |
|---|
| 204 | maxOccurs="1"/> |
|---|
| 205 | <xsd:element name="name" type="tns:IDType" minOccurs="0" maxOccurs="1"/> |
|---|
| 206 | <xsd:element name="user" type="tns:userType" minOccurs="0" |
|---|
| 207 | maxOccurs="unbounded"/> |
|---|
| 208 | </xsd:sequence> |
|---|
| 209 | </xsd:complexType> |
|---|
| 210 | |
|---|
| 211 | <xsd:complexType name="emulabType"> |
|---|
| 212 | <xsd:annotation> |
|---|
| 213 | <xsd:documentation> |
|---|
| 214 | A description of an Emulab sufficient for the federation system |
|---|
| 215 | to create a sub experiment on it. Note that fedAttrs provide an |
|---|
| 216 | extension mechanism by which testbeds may communicate additional |
|---|
| 217 | information and preferences to federation systems that |
|---|
| 218 | understand it. |
|---|
| 219 | </xsd:documentation> |
|---|
| 220 | </xsd:annotation> |
|---|
| 221 | <xsd:sequence> |
|---|
| 222 | <xsd:element name="project" type="tns:projectType"/> |
|---|
| 223 | <xsd:element name="domain" type="xsd:string"/> |
|---|
| 224 | <xsd:element name="boss" type="xsd:string"/> |
|---|
| 225 | <xsd:element name="ops" type="xsd:string"/> |
|---|
| 226 | <xsd:element name="fileServer" type="xsd:string"/> |
|---|
| 227 | <xsd:element name="eventServer" type="xsd:string"/> |
|---|
| 228 | <xsd:element name="fedAttr" type="tns:fedAttrType" minOccurs="0" |
|---|
| 229 | maxOccurs="unbounded"/> |
|---|
| 230 | </xsd:sequence> |
|---|
| 231 | </xsd:complexType> |
|---|
| 232 | |
|---|
| 233 | <xsd:complexType name="federatedExperimentType"> |
|---|
| 234 | <xsd:annotation> |
|---|
| 235 | <xsd:documentation> |
|---|
| 236 | Naming and Emulab instantiation information about a federant. |
|---|
| 237 | This is returned by various informational requests and as part |
|---|
| 238 | of a successful creation message. |
|---|
| 239 | </xsd:documentation> |
|---|
| 240 | </xsd:annotation> |
|---|
| 241 | <xsd:sequence> |
|---|
| 242 | <xsd:element name="name" type="tns:IDType" minOccurs="1" |
|---|
| 243 | maxOccurs="unbounded"/> |
|---|
| 244 | <xsd:element name="emulab" type="tns:emulabType" minOccurs="0" |
|---|
| 245 | maxOccurs="1"/> |
|---|
| 246 | <xsd:element name="master" type="xsd:boolean"/> |
|---|
| 247 | </xsd:sequence> |
|---|
| 248 | </xsd:complexType> |
|---|
| 249 | |
|---|
| 250 | |
|---|
| 251 | <xsd:complexType name="vtoponodeType"> |
|---|
| 252 | <xsd:annotation> |
|---|
| 253 | <xsd:documentation> |
|---|
| 254 | Node in the virtual topology of a federated experiment (Emulab |
|---|
| 255 | legacy). The fields are the local hostname and the IP addresses |
|---|
| 256 | of the experimental interfaces(colon-separated). |
|---|
| 257 | </xsd:documentation> |
|---|
| 258 | </xsd:annotation> |
|---|
| 259 | <xsd:sequence> |
|---|
| 260 | <xsd:element name="vname" type="xsd:string"/> |
|---|
| 261 | <xsd:element name="ips" type="xsd:string"/> |
|---|
| 262 | </xsd:sequence> |
|---|
| 263 | </xsd:complexType> |
|---|
| 264 | |
|---|
| 265 | <xsd:complexType name="vtopolanType"> |
|---|
| 266 | <xsd:annotation> |
|---|
| 267 | <xsd:documentation> |
|---|
| 268 | LAN in the virtual topology of a federated experiment (Emulab legacy). |
|---|
| 269 | The fields are the name of the LAN/link (vname) the node that |
|---|
| 270 | this description applies to (vnode), the IP of the connection, |
|---|
| 271 | and performance information. |
|---|
| 272 | </xsd:documentation> |
|---|
| 273 | </xsd:annotation> |
|---|
| 274 | <xsd:sequence> |
|---|
| 275 | <xsd:element name="vname" type="xsd:string"/> |
|---|
| 276 | <xsd:element name="vnode" type="xsd:string"/> |
|---|
| 277 | <xsd:element name="ip" type="xsd:string"/> |
|---|
| 278 | <xsd:element name="bandwidth" type="xsd:int"/> |
|---|
| 279 | <xsd:element name="delay" type="xsd:float"/> |
|---|
| 280 | <xsd:element name="member" type="xsd:string"/> |
|---|
| 281 | </xsd:sequence> |
|---|
| 282 | </xsd:complexType> |
|---|
| 283 | |
|---|
| 284 | <xsd:complexType name="vtopoType"> |
|---|
| 285 | <xsd:annotation> |
|---|
| 286 | <xsd:documentation> |
|---|
| 287 | The virtual topology of a federated experiment (Emulab legacy). |
|---|
| 288 | </xsd:documentation> |
|---|
| 289 | </xsd:annotation> |
|---|
| 290 | <xsd:sequence> |
|---|
| 291 | <xsd:element name="node" type="tns:vtoponodeType" minOccurs="0" |
|---|
| 292 | maxOccurs="unbounded" /> |
|---|
| 293 | <xsd:element name="lan" type="tns:vtopolanType" minOccurs="0" |
|---|
| 294 | maxOccurs="unbounded"/> |
|---|
| 295 | </xsd:sequence> |
|---|
| 296 | </xsd:complexType> |
|---|
| 297 | |
|---|
| 298 | <xsd:complexType name="visnodeType"> |
|---|
| 299 | <xsd:annotation> |
|---|
| 300 | <xsd:documentation> |
|---|
| 301 | Node in the visualization of a federated experiment (Emulab |
|---|
| 302 | legacy). Fields include the local hostname of the node, x,y |
|---|
| 303 | coordinates in a 2-dimensional representation, and whether the |
|---|
| 304 | node in the visualization is a host or a LAN. |
|---|
| 305 | </xsd:documentation> |
|---|
| 306 | </xsd:annotation> |
|---|
| 307 | <xsd:sequence> |
|---|
| 308 | <xsd:element name="name" type="xsd:string"/> |
|---|
| 309 | <xsd:element name="x" type="xsd:int"/> |
|---|
| 310 | <xsd:element name="y" type="xsd:int"/> |
|---|
| 311 | <xsd:element name="type" type="xsd:string"/> |
|---|
| 312 | </xsd:sequence> |
|---|
| 313 | </xsd:complexType> |
|---|
| 314 | |
|---|
| 315 | <xsd:complexType name="visType"> |
|---|
| 316 | <xsd:annotation> |
|---|
| 317 | <xsd:documentation> |
|---|
| 318 | The visualization of a federated experiment (Emulab legacy) |
|---|
| 319 | </xsd:documentation> |
|---|
| 320 | </xsd:annotation> |
|---|
| 321 | <xsd:sequence> |
|---|
| 322 | <xsd:element name="node" type="tns:visnodeType" minOccurs="0" |
|---|
| 323 | maxOccurs="unbounded"/> |
|---|
| 324 | </xsd:sequence> |
|---|
| 325 | </xsd:complexType> |
|---|
| 326 | |
|---|
| 327 | <xsd:complexType name="projectAllocType"> |
|---|
| 328 | <xsd:annotation> |
|---|
| 329 | <xsd:documentation> |
|---|
| 330 | The information needed to create a dynamic project, specifically |
|---|
| 331 | a project description and the resources in needs access to. |
|---|
| 332 | This is used by an internal fedd interface. |
|---|
| 333 | </xsd:documentation> |
|---|
| 334 | </xsd:annotation> |
|---|
| 335 | <xsd:sequence> |
|---|
| 336 | <xsd:element name="project" type="tns:projectType"/> |
|---|
| 337 | <xsd:element name="resources" type="tns:resourcesType" |
|---|
| 338 | minOccurs="0" maxOccurs="1"/> |
|---|
| 339 | </xsd:sequence> |
|---|
| 340 | </xsd:complexType> |
|---|
| 341 | |
|---|
| 342 | <xsd:complexType name="experimentDescriptionType"> |
|---|
| 343 | <xsd:annotation> |
|---|
| 344 | <xsd:documentation> |
|---|
| 345 | The description of the federated experiment, in extended ns2. |
|---|
| 346 | </xsd:documentation> |
|---|
| 347 | </xsd:annotation> |
|---|
| 348 | <xsd:choice> |
|---|
| 349 | <xsd:element name="ns2description" type="xsd:base64Binary"/> |
|---|
| 350 | <xsd:element name="topdldescription" type="topdl:topologyType"/> |
|---|
| 351 | </xsd:choice> |
|---|
| 352 | </xsd:complexType> |
|---|
| 353 | |
|---|
| 354 | <xsd:complexType name="requestType"> |
|---|
| 355 | <xsd:annotation> |
|---|
| 356 | <xsd:documentation> |
|---|
| 357 | Request for access to a testbed. It includes the testbed from |
|---|
| 358 | which resources are being requested (a single service may |
|---|
| 359 | provide access to many), the user or project requesting access |
|---|
| 360 | (a testbed making the request will leave both empty), the |
|---|
| 361 | resources needed, the access keys to be used in the subsequent |
|---|
| 362 | instantiation and service use, an allocation ID to identify this |
|---|
| 363 | access in later requests, and scheduling information. |
|---|
| 364 | </xsd:documentation> |
|---|
| 365 | </xsd:annotation> |
|---|
| 366 | <xsd:sequence> |
|---|
| 367 | <xsd:element name="destinationTestbed" type="tns:IDType" |
|---|
| 368 | minOccurs="0" maxOccurs="1" /> |
|---|
| 369 | <xsd:choice> |
|---|
| 370 | <xsd:element name="project" type="tns:projectType" minOccurs="0" |
|---|
| 371 | maxOccurs="1"/> |
|---|
| 372 | <xsd:element name="user" type="tns:userType" minOccurs="0" |
|---|
| 373 | maxOccurs="unbounded"/> |
|---|
| 374 | </xsd:choice> |
|---|
| 375 | <xsd:element name="resources" type="tns:resourcesType" minOccurs="0" |
|---|
| 376 | maxOccurs="1"/> |
|---|
| 377 | <xsd:element name="createAccess" type="tns:accessType" minOccurs="1" |
|---|
| 378 | maxOccurs="unbounded"/> |
|---|
| 379 | <xsd:element name="serviceAccess" type="tns:accessType" minOccurs="1" |
|---|
| 380 | maxOccurs="unbounded"/> |
|---|
| 381 | <xsd:element name="exportProject" type="tns:IDType" |
|---|
| 382 | minOccurs="0" maxOccurs="1"/> |
|---|
| 383 | <xsd:element name="allocID" type="tns:IDType"/> |
|---|
| 384 | <xsd:element name="when" type="xsd:dateTime" minOccurs="0" maxOccurs="1"/> |
|---|
| 385 | <xsd:element name="until" type="xsd:dateTime" minOccurs="0" |
|---|
| 386 | maxOccurs="1"/> |
|---|
| 387 | </xsd:sequence> |
|---|
| 388 | </xsd:complexType> |
|---|
| 389 | |
|---|
| 390 | <xsd:complexType name="responseType"> |
|---|
| 391 | <xsd:annotation> |
|---|
| 392 | <xsd:documentation> |
|---|
| 393 | Response to an access request. Includes the allocation, the |
|---|
| 394 | information needed to access creation and experiment services |
|---|
| 395 | and scheduling information. |
|---|
| 396 | </xsd:documentation> |
|---|
| 397 | </xsd:annotation> |
|---|
| 398 | <xsd:sequence> |
|---|
| 399 | <xsd:element name="allocID" type="tns:IDType"/> |
|---|
| 400 | <xsd:element name="emulab" type="tns:emulabType" minOccurs="0" maxOccurs="1"/> |
|---|
| 401 | <xsd:element name="when" type="xsd:dateTime" minOccurs="0" maxOccurs="1"/> |
|---|
| 402 | <xsd:element name="until" type="xsd:dateTime" minOccurs="0" |
|---|
| 403 | maxOccurs="1"/> |
|---|
| 404 | </xsd:sequence> |
|---|
| 405 | </xsd:complexType> |
|---|
| 406 | |
|---|
| 407 | <xsd:complexType name="releaseRequestType"> |
|---|
| 408 | <xsd:annotation> |
|---|
| 409 | <xsd:documentation> |
|---|
| 410 | A request to release the access rights allocated by an earlier |
|---|
| 411 | RequestAccess call. |
|---|
| 412 | </xsd:documentation> |
|---|
| 413 | </xsd:annotation> |
|---|
| 414 | <xsd:sequence> |
|---|
| 415 | <xsd:element name="allocID" type="tns:IDType"/> |
|---|
| 416 | </xsd:sequence> |
|---|
| 417 | </xsd:complexType> |
|---|
| 418 | |
|---|
| 419 | <xsd:complexType name="releaseResponseType"> |
|---|
| 420 | <xsd:annotation> |
|---|
| 421 | <xsd:documentation> |
|---|
| 422 | Indication that the access has been terminated. |
|---|
| 423 | </xsd:documentation> |
|---|
| 424 | </xsd:annotation> |
|---|
| 425 | <xsd:sequence> |
|---|
| 426 | <xsd:element name="allocID" type="tns:IDType"/> |
|---|
| 427 | </xsd:sequence> |
|---|
| 428 | </xsd:complexType> |
|---|
| 429 | |
|---|
| 430 | <xsd:complexType name="createRequestType"> |
|---|
| 431 | <xsd:annotation> |
|---|
| 432 | <xsd:documentation> |
|---|
| 433 | A request to embed a federated experiment across testbeds. Non- |
|---|
| 434 | standard local names for testbeds are included in the |
|---|
| 435 | testbedmap, the user making the request, the experiment |
|---|
| 436 | description, master testbed, and a suggested experiment name are |
|---|
| 437 | included. More than one name can be suggested, either as |
|---|
| 438 | synonyms (a fedid and a localname) or as choices (multiple |
|---|
| 439 | localnames). |
|---|
| 440 | </xsd:documentation> |
|---|
| 441 | </xsd:annotation> |
|---|
| 442 | <xsd:sequence> |
|---|
| 443 | <xsd:element name="testbedmap" type="tns:mapType" minOccurs="0" |
|---|
| 444 | maxOccurs="unbounded"/> |
|---|
| 445 | <xsd:element name="user" type="tns:userType" minOccurs="1" |
|---|
| 446 | maxOccurs="unbounded"/> |
|---|
| 447 | <xsd:element name="experimentdescription" |
|---|
| 448 | type="tns:experimentDescriptionType"/> |
|---|
| 449 | <xsd:element name="master" type="xsd:string"/> |
|---|
| 450 | <xsd:element name='exportProject' type="tns:IDType"/> |
|---|
| 451 | <xsd:element name="experimentID" type="tns:IDType" minOccurs="0" |
|---|
| 452 | maxOccurs="1"/> |
|---|
| 453 | </xsd:sequence> |
|---|
| 454 | </xsd:complexType> |
|---|
| 455 | |
|---|
| 456 | <xsd:complexType name="createResponseType"> |
|---|
| 457 | <xsd:annotation> |
|---|
| 458 | <xsd:documentation> |
|---|
| 459 | Returned to let the caller know that the request is underway and what |
|---|
| 460 | credentials will eventauly be able to be used to access them. |
|---|
| 461 | </xsd:documentation> |
|---|
| 462 | </xsd:annotation> |
|---|
| 463 | <xsd:sequence> |
|---|
| 464 | <xsd:element name="experimentID" type="tns:IDType" minOccurs="1" |
|---|
| 465 | maxOccurs="unbounded"/> |
|---|
| 466 | <xsd:element name="experimentStatus" type="tns:statusType"/> |
|---|
| 467 | <xsd:element name="experimentAccess" type="tns:accessType" minOccurs="0" |
|---|
| 468 | maxOccurs="1"/> |
|---|
| 469 | </xsd:sequence> |
|---|
| 470 | </xsd:complexType> |
|---|
| 471 | |
|---|
| 472 | <xsd:complexType name="vtopoRequestType"> |
|---|
| 473 | <xsd:annotation> |
|---|
| 474 | <xsd:documentation> |
|---|
| 475 | Request for an existing experiment's virtual topology. |
|---|
| 476 | Different information may be returned based on the user's rights |
|---|
| 477 | to see the topology. |
|---|
| 478 | </xsd:documentation> |
|---|
| 479 | </xsd:annotation> |
|---|
| 480 | <xsd:sequence> |
|---|
| 481 | <xsd:element name="experiment" type="tns:IDType"/> |
|---|
| 482 | </xsd:sequence> |
|---|
| 483 | </xsd:complexType> |
|---|
| 484 | |
|---|
| 485 | <xsd:complexType name="vtopoResponseType"> |
|---|
| 486 | <xsd:annotation> |
|---|
| 487 | <xsd:documentation> |
|---|
| 488 | The response to a topology request. Different information may |
|---|
| 489 | be returned based on the user's rights to see the topology. |
|---|
| 490 | </xsd:documentation> |
|---|
| 491 | </xsd:annotation> |
|---|
| 492 | <xsd:sequence> |
|---|
| 493 | <xsd:element name="experiment" type="tns:IDType"/> |
|---|
| 494 | <xsd:element name="vtopo" type="tns:vtopoType"/> |
|---|
| 495 | </xsd:sequence> |
|---|
| 496 | </xsd:complexType> |
|---|
| 497 | |
|---|
| 498 | |
|---|
| 499 | <xsd:complexType name="visRequestType"> |
|---|
| 500 | <xsd:annotation> |
|---|
| 501 | <xsd:documentation> |
|---|
| 502 | Request for an existing experiment's visualization. This is |
|---|
| 503 | largely a compatibility service. Different information may be |
|---|
| 504 | returned based on the user's rights to see the topology. |
|---|
| 505 | </xsd:documentation> |
|---|
| 506 | </xsd:annotation> |
|---|
| 507 | <xsd:sequence> |
|---|
| 508 | <xsd:element name="experiment" type="tns:IDType"/> |
|---|
| 509 | </xsd:sequence> |
|---|
| 510 | </xsd:complexType> |
|---|
| 511 | |
|---|
| 512 | <xsd:complexType name="visResponseType"> |
|---|
| 513 | <xsd:annotation> |
|---|
| 514 | <xsd:documentation> |
|---|
| 515 | An existing experiment's visualization. This is largely a |
|---|
| 516 | compatibility service. Different information may be returned |
|---|
| 517 | based on the user's rights to see the topology. |
|---|
| 518 | </xsd:documentation> |
|---|
| 519 | </xsd:annotation> |
|---|
| 520 | <xsd:sequence> |
|---|
| 521 | <xsd:element name="experiment" type="tns:IDType"/> |
|---|
| 522 | <xsd:element name="vis" type="tns:visType"/> |
|---|
| 523 | </xsd:sequence> |
|---|
| 524 | </xsd:complexType> |
|---|
| 525 | |
|---|
| 526 | <xsd:complexType name="infoRequestType"> |
|---|
| 527 | <xsd:annotation> |
|---|
| 528 | <xsd:documentation> |
|---|
| 529 | A combined topology, visualalization, and federant request. |
|---|
| 530 | Different information may be returned based on the user's rights |
|---|
| 531 | to see the topology. |
|---|
| 532 | </xsd:documentation> |
|---|
| 533 | </xsd:annotation> |
|---|
| 534 | <xsd:sequence> |
|---|
| 535 | <xsd:element name="experiment" type="tns:IDType"/> |
|---|
| 536 | </xsd:sequence> |
|---|
| 537 | </xsd:complexType> |
|---|
| 538 | |
|---|
| 539 | <xsd:complexType name="infoResponseType"> |
|---|
| 540 | <xsd:annotation> |
|---|
| 541 | <xsd:documentation> |
|---|
| 542 | Information on an instantiated experiment. Different information may |
|---|
| 543 | be returned based on the user's rights to see the topology. Includes |
|---|
| 544 | the information about federants hosting sub-experiments for service |
|---|
| 545 | access as well as virtual topology and visualization information. All |
|---|
| 546 | that information is relative to the requester. ExperimentAccess |
|---|
| 547 | includes credentials with which one can access the experiment. These |
|---|
| 548 | may include a public key necessary to prove possession of the |
|---|
| 549 | credential and should be treated with care. |
|---|
| 550 | </xsd:documentation> |
|---|
| 551 | </xsd:annotation> |
|---|
| 552 | <xsd:sequence> |
|---|
| 553 | <xsd:element name="federant" type="tns:federatedExperimentType" |
|---|
| 554 | minOccurs="0" maxOccurs="unbounded"/> |
|---|
| 555 | <xsd:element name="vtopo" type="tns:vtopoType" minOccurs="0" |
|---|
| 556 | maxOccurs="1"/> |
|---|
| 557 | <xsd:element name="vis" type="tns:visType" minOccurs="0" |
|---|
| 558 | maxOccurs="1"/> |
|---|
| 559 | <xsd:element name="experimentID" type="tns:IDType" minOccurs="1" |
|---|
| 560 | maxOccurs="unbounded"/> |
|---|
| 561 | <xsd:element name="allocationLog" type="xsd:string" minOccurs="0" |
|---|
| 562 | maxOccurs="1"/> |
|---|
| 563 | <xsd:element name="experimentStatus" type="tns:statusType"/> |
|---|
| 564 | <xsd:element name="experimentAccess" type="tns:accessType" minOccurs="0" |
|---|
| 565 | maxOccurs="1"/> |
|---|
| 566 | </xsd:sequence> |
|---|
| 567 | </xsd:complexType> |
|---|
| 568 | |
|---|
| 569 | |
|---|
| 570 | <xsd:complexType name="multiInfoRequestType"> |
|---|
| 571 | <xsd:annotation> |
|---|
| 572 | <xsd:documentation> |
|---|
| 573 | Gets all information that this user can access on this fedd. |
|---|
| 574 | </xsd:documentation> |
|---|
| 575 | </xsd:annotation> |
|---|
| 576 | <xsd:sequence> |
|---|
| 577 | </xsd:sequence> |
|---|
| 578 | </xsd:complexType> |
|---|
| 579 | |
|---|
| 580 | <xsd:complexType name="multiInfoResponseType"> |
|---|
| 581 | <xsd:annotation> |
|---|
| 582 | <xsd:documentation> |
|---|
| 583 | Multi info response. A list of infoResponses |
|---|
| 584 | </xsd:documentation> |
|---|
| 585 | </xsd:annotation> |
|---|
| 586 | <xsd:sequence> |
|---|
| 587 | <xsd:element name="info" type="tns:infoResponseType" minOccurs="0" |
|---|
| 588 | maxOccurs="unbounded"/> |
|---|
| 589 | </xsd:sequence> |
|---|
| 590 | </xsd:complexType> |
|---|
| 591 | |
|---|
| 592 | <xsd:complexType name="terminateRequestType"> |
|---|
| 593 | <xsd:annotation> |
|---|
| 594 | <xsd:documentation> |
|---|
| 595 | Request to terminate an experiment. |
|---|
| 596 | </xsd:documentation> |
|---|
| 597 | </xsd:annotation> |
|---|
| 598 | <xsd:sequence> |
|---|
| 599 | <xsd:element name="experiment" type="tns:IDType"/> |
|---|
| 600 | <xsd:element name="force" type="xsd:boolean" minOccurs="0" maxOccurs="1"/> |
|---|
| 601 | </xsd:sequence> |
|---|
| 602 | </xsd:complexType> |
|---|
| 603 | |
|---|
| 604 | <xsd:complexType name="terminateResponseType"> |
|---|
| 605 | <xsd:annotation> |
|---|
| 606 | <xsd:documentation> |
|---|
| 607 | Indication that the experiment has been terminated. |
|---|
| 608 | </xsd:documentation> |
|---|
| 609 | </xsd:annotation> |
|---|
| 610 | <xsd:sequence> |
|---|
| 611 | <xsd:element name="experiment" type="tns:IDType"/> |
|---|
| 612 | <xsd:element name="deallocationLog" type="xsd:string" minOccurs="0" |
|---|
| 613 | maxOccurs="1"/> |
|---|
| 614 | </xsd:sequence> |
|---|
| 615 | </xsd:complexType> |
|---|
| 616 | |
|---|
| 617 | <xsd:complexType name="startSegmentRequestType"> |
|---|
| 618 | <xsd:annotation> |
|---|
| 619 | <xsd:documentation> |
|---|
| 620 | Request a testbed to create a segment in the given allocation |
|---|
| 621 | </xsd:documentation> |
|---|
| 622 | </xsd:annotation> |
|---|
| 623 | <xsd:sequence> |
|---|
| 624 | <xsd:element name="allocID" type="tns:IDType"/> |
|---|
| 625 | <xsd:element name="segmentdescription" |
|---|
| 626 | type="tns:experimentDescriptionType"/> |
|---|
| 627 | <xsd:element name="master" type="xsd:boolean"/> |
|---|
| 628 | <xsd:element name="fedAttr" type="tns:fedAttrType" minOccurs="0" |
|---|
| 629 | maxOccurs="unbounded"/> |
|---|
| 630 | </xsd:sequence> |
|---|
| 631 | </xsd:complexType> |
|---|
| 632 | |
|---|
| 633 | <xsd:complexType name="startSegmentResponseType"> |
|---|
| 634 | <xsd:annotation> |
|---|
| 635 | <xsd:documentation> |
|---|
| 636 | Indication that the segment started successfully |
|---|
| 637 | </xsd:documentation> |
|---|
| 638 | </xsd:annotation> |
|---|
| 639 | <xsd:sequence> |
|---|
| 640 | <xsd:element name="allocID" type="tns:IDType"/> |
|---|
| 641 | <xsd:element name="allocationLog" type="xsd:string" minOccurs="0" |
|---|
| 642 | maxOccurs="1"/> |
|---|
| 643 | <xsd:element name="fedAttr" type="tns:fedAttrType" minOccurs="0" |
|---|
| 644 | maxOccurs="unbounded"/> |
|---|
| 645 | </xsd:sequence> |
|---|
| 646 | </xsd:complexType> |
|---|
| 647 | |
|---|
| 648 | <xsd:complexType name="terminateSegmentRequestType"> |
|---|
| 649 | <xsd:annotation> |
|---|
| 650 | <xsd:documentation> |
|---|
| 651 | Request to terminate an experiment. |
|---|
| 652 | </xsd:documentation> |
|---|
| 653 | </xsd:annotation> |
|---|
| 654 | <xsd:sequence> |
|---|
| 655 | <xsd:element name="allocID" type="tns:IDType"/> |
|---|
| 656 | <xsd:element name="force" type="xsd:boolean" minOccurs="0" maxOccurs="1"/> |
|---|
| 657 | </xsd:sequence> |
|---|
| 658 | </xsd:complexType> |
|---|
| 659 | |
|---|
| 660 | <xsd:complexType name="terminateSegmentResponseType"> |
|---|
| 661 | <xsd:annotation> |
|---|
| 662 | <xsd:documentation> |
|---|
| 663 | Indication that the experiment has been terminated. |
|---|
| 664 | </xsd:documentation> |
|---|
| 665 | </xsd:annotation> |
|---|
| 666 | <xsd:sequence> |
|---|
| 667 | <xsd:element name="allocID" type="tns:IDType"/> |
|---|
| 668 | <xsd:element name="deallocationLog" type="xsd:string" minOccurs="0" |
|---|
| 669 | maxOccurs="1"/> |
|---|
| 670 | </xsd:sequence> |
|---|
| 671 | </xsd:complexType> |
|---|
| 672 | |
|---|
| 673 | <xsd:complexType name="ns2SplitRequestType"> |
|---|
| 674 | <xsd:annotation> |
|---|
| 675 | <xsd:documentation> |
|---|
| 676 | Request to run the CEDL splitter remotely. This is primarily an |
|---|
| 677 | internal interface. |
|---|
| 678 | </xsd:documentation> |
|---|
| 679 | </xsd:annotation> |
|---|
| 680 | <xsd:sequence> |
|---|
| 681 | <xsd:element name="description" type="tns:experimentDescriptionType"/> |
|---|
| 682 | <xsd:element name="master" type="xsd:string"/> |
|---|
| 683 | <xsd:element name="include_fedkit" type="xsd:boolean"/> |
|---|
| 684 | <xsd:element name="include_gatewaykit" type="xsd:boolean"/> |
|---|
| 685 | </xsd:sequence> |
|---|
| 686 | </xsd:complexType> |
|---|
| 687 | |
|---|
| 688 | <xsd:complexType name="ns2SplitResponseType"> |
|---|
| 689 | <xsd:annotation> |
|---|
| 690 | <xsd:documentation> |
|---|
| 691 | Remote splitter output. Also an internal interface |
|---|
| 692 | </xsd:documentation> |
|---|
| 693 | </xsd:annotation> |
|---|
| 694 | <xsd:sequence> |
|---|
| 695 | <xsd:element name="output" type="xsd:base64Binary"/> |
|---|
| 696 | <xsd:element name="experimentdescription" |
|---|
| 697 | type="tns:experimentDescriptionType"/> |
|---|
| 698 | </xsd:sequence> |
|---|
| 699 | </xsd:complexType> |
|---|
| 700 | |
|---|
| 701 | |
|---|
| 702 | <xsd:complexType name="faultType"> |
|---|
| 703 | <xsd:annotation> |
|---|
| 704 | <xsd:documentation> |
|---|
| 705 | Indication that a service has failed. The code values are |
|---|
| 706 | |
|---|
| 707 | 1 access denied |
|---|
| 708 | 2 proxy error |
|---|
| 709 | 3 badly formed request |
|---|
| 710 | 4 server configuration error |
|---|
| 711 | 5 internal error |
|---|
| 712 | 6 partial instantiation |
|---|
| 713 | 7 federant error |
|---|
| 714 | |
|---|
| 715 | Errstr contains the text above corresponding to the code. Code |
|---|
| 716 | is always present. Desc provides additional human-readable data |
|---|
| 717 | about the error. |
|---|
| 718 | </xsd:documentation> |
|---|
| 719 | </xsd:annotation> |
|---|
| 720 | <xsd:sequence> |
|---|
| 721 | <xsd:element name="code" type="xsd:int"> |
|---|
| 722 | <xsd:restriction> |
|---|
| 723 | <xsd:enumeration value="1"/> <!-- access denied --> |
|---|
| 724 | <xsd:enumeration value="2"/> <!-- protocol error --> |
|---|
| 725 | <xsd:enumeration value="3"/> <!-- badly formed request --> |
|---|
| 726 | <xsd:enumeration value="4"/> <!-- server configuration error --> |
|---|
| 727 | <xsd:enumeration value="5"/> <!-- internal error --> |
|---|
| 728 | <xsd:enumeration value="6"/> <!-- partial instantiation --> |
|---|
| 729 | <xsd:enumeration value="7"/> <!-- federant error --> |
|---|
| 730 | <xsd:enumeration value="8"/> <!-- connect error --> |
|---|
| 731 | </xsd:restriction> |
|---|
| 732 | </xsd:element> |
|---|
| 733 | <xsd:element name="errstr" minOccurs="0" maxOccurs="1" type="xsd:string"> |
|---|
| 734 | </xsd:element> |
|---|
| 735 | <xsd:element name="desc" type="xsd:string"/> |
|---|
| 736 | </xsd:sequence> |
|---|
| 737 | </xsd:complexType> |
|---|
| 738 | </xsd:schema> |
|---|
