Changes between Version 12 and Version 13 of AaronHelsinger/GAPI_AM_API_DRAFT
- Timestamp:
- 03/22/12 16:01:43 (12 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
AaronHelsinger/GAPI_AM_API_DRAFT
v12 v13 134 134 {{{ 135 135 { 136 string ticket=<ticket>137 string geni_status=<sliver state - ticketed>,136 ticket: <string, the ticket> 137 geni_status: <string, the sliver state - ticketed>, 138 138 <others that are AM specific> 139 139 } … … 471 471 value = [ 472 472 { 473 geni_sliver_urn ,474 geni_allocation_status ,475 geni_expires <time when the sliver expires from its current state>,473 geni_sliver_urn: <string>, 474 geni_allocation_status: <string>, 475 geni_expires: <time when the sliver expires from its current state>, 476 476 <others AM or method specific> 477 477 <ProvisionSlivers returns geni_operational_status> … … 487 487 These methods all take a new option (aggregates must support it, clients do not need to supply it): 488 488 {{{ 489 geni_best_effort = True/False, default False489 geni_best_effort: <True/False, default False> 490 490 }}} 491 491 If false, the client is requesting that the aggregate either fully satisfy the request, moving all listed slivers to the desired state, or fully fail the request, leaving all slivers in their original state. … … 571 571 geni_credential_types = <a list of structs>: [ 572 572 { 573 geni_type =<string, case insensitive>,574 geni_version =<string containing an integer>,573 geni_type: <string, case insensitive>, 574 geni_version: <string containing an integer>, 575 575 <others fields optionally. EG A URL for more info, or a schema> 576 576 } … … 611 611 credentials = [ 612 612 { 613 geni_type =<string>,614 geni_version =<string>,615 geni_value =<string>,613 geni_type: <string>, 614 geni_version: <string>, 615 geni_value: <string>, 616 616 <others> 617 617 } … … 697 697 {{{ 698 698 { 699 string rspec=<manifest>, 700 string geni_start_time=<optional (may be omitted altogether): now if not specified>, 701 string geni_expires=<RFC3339 sliver expiration, as in geni_expires from SliversStatus>, 702 string geni_status=<sliver state - allocated or changing or ready>, 699 rspec: <string manifest>, 700 geni_expires: =<RFC3339 sliver expiration string, as in geni_expires from SliversStatus>, 701 geni_allocation_status: <string sliver state - allocated or changing or ready>, 703 702 <others that are AM specific> 704 703 } … … 912 911 credentials = [ 913 912 { 914 geni_type =<string>,915 geni_version =<string>,916 geni_value =<string>,913 geni_type: <string>, 914 geni_version: <string>, 915 geni_value: <string>, 917 916 <others> 918 917 } … … 923 922 {{{ 924 923 { 925 string geni_rspec (ad or Manifest - may be empty though)926 string geni_urn, (slice or sliver as requested)927 geni_expires =<RFC3339 allocation expiration, as in geni_expires from SliversStatus>,928 string geni_allocation_status=<sliver state - allocated or ?? >,924 geni_rspec: <string, ad or Manifest - may be empty though)> 925 geni_urn: <string urn, slice or sliver as requested> 926 geni_expires: <RFC3339 allocation expiration string, as in geni_expires from SliversStatus>, 927 geni_allocation_status: <string sliver state - allocated or ?? >, 929 928 } 930 929 }}} … … 945 944 credentials = [ 946 945 { 947 geni_type =<string>,948 geni_version =<string>,949 geni_value =<string>,946 geni_type: <string>, 947 geni_version: <string>, 948 geni_value: <string>, 950 949 <others> 951 950 } … … 956 955 {{{ 957 956 { 958 string geni_end_time <datetime> (optional)957 [optional geni_end_time: <string datetime>] 959 958 } 960 959 }}} … … 963 962 {{{ 964 963 { 965 string rspec=<manifest>,966 geni_expires =<RFC3339 allocation expiration, as in geni_expires from SliversStatus>,967 string geni_allocation_status=<sliver state - allocated or ?? >,964 rspec: <string manifest>, 965 geni_expires: <RFC3339 allocation expiration string, as in geni_expires from SliversStatus>, 966 geni_allocation_status: <string sliver state - allocated or ?? >, 968 967 <others that are AM specific> 969 968 } … … 984 983 credentials = [ 985 984 { 986 geni_type =<string>,987 geni_version =<string>,988 geni_value =<string>,985 geni_type: <string>, 986 geni_version: <string>, 987 geni_value: <string>, 989 988 <others> 990 989 } … … 992 991 }}} 993 992 994 Options include {{{geni_best_effort = True/False, default false}}}993 Options include {{{geni_best_effort: <True/False, default false>}}} 995 994 996 995 Return list of structs: … … 998 997 [ 999 998 { 1000 geni_sliver_urn ,1001 geni_allocation_status ,1002 geni_expires <time when the sliver expires from its current state>,999 geni_sliver_urn: <string>, 1000 geni_allocation_status: <string>, 1001 geni_expires: <time when the sliver expires from its current state>, 1003 1002 <others AM or method specific> 1004 1003 }, … … 1017 1016 credentials = [ 1018 1017 { 1019 geni_type =<string>,1020 geni_version =<string>,1021 geni_value =<string>,1018 geni_type: <string>, 1019 geni_version: <string>, 1020 geni_value: <string>, 1022 1021 <others> 1023 1022 } … … 1025 1024 }}} 1026 1025 1027 Options include {{{geni_end_time}}} and {{{geni_best_effort = True/False, default false}}}1026 Options include {{{geni_end_time}}} and {{{geni_best_effort: <True/False, default false>}}} 1028 1027 1029 1028 Return a list of structs: … … 1031 1030 [ 1032 1031 { 1033 geni_sliver_urn ,1034 geni_allocation_status ,1035 geni_expires <time when the sliver expires from its current state>,1032 geni_sliver_urn: <string>, 1033 geni_allocation_status: <string>, 1034 geni_expires: <time when the sliver expires from its current state>, 1036 1035 <others AM or method specific> 1037 1036 }, … … 1050 1049 credentials = [ 1051 1050 { 1052 geni_type =<string>,1053 geni_version =<string>,1054 geni_value =<string>,1051 geni_type: <string>, 1052 geni_version: <string>, 1053 geni_value: <string>, 1055 1054 <others> 1056 1055 } … … 1064 1063 [ 1065 1064 { 1066 geni_sliver_urn, 1067 geni_allocation_status, 1068 geni_operational_status, 1069 [optional: 'geni_resource_status' : string] 1065 geni_sliver_urn: <string>, 1066 geni_allocation_status: <string>, 1067 geni_operational_status: <string>, 1070 1068 geni_expires <time when the sliver expires from its current state>, 1069 [optional: geni_resource_status: <string>] 1071 1070 <others AM or method specific> 1072 1071 }, … … 1088 1087 credentials = [ 1089 1088 { 1090 geni_type =<string>,1091 geni_version =<string>,1092 geni_value =<string>,1089 geni_type: <string>, 1090 geni_version: <string>, 1091 geni_value: <string>, 1093 1092 <others> 1094 1093 } … … 1096 1095 }}} 1097 1096 1098 Options include {{{geni_end_time}}} and {{{geni_best_effort = True/False, default false}}}1097 Options include {{{geni_end_time}}} and {{{geni_best_effort: <True/False, default false>}}} 1099 1098 1100 1099 Return struct: 1101 1100 {{{ 1102 1101 { 1103 string ticket=<ticket> 1104 string geni_status=<sliver state - ticketed>, 1102 rspec: <string rspec> 1103 geni_allocation_status: <sliver state - allocated>, 1104 geni_expires: <datetime>. 1105 1105 <others that are AM specific> 1106 1106 } … … 1120 1120 credentials = [ 1121 1121 { 1122 geni_type =<string>,1123 geni_version =<string>,1124 geni_value =<string>,1122 geni_type: <string>, 1123 geni_version: <string>, 1124 geni_value: <string>, 1125 1125 <others> 1126 1126 } … … 1128 1128 }}} 1129 1129 1130 Options include {{{geni_best_effort = True/False, default false}}}1130 Options include {{{geni_best_effort: <True/False, default false>}}} 1131 1131 1132 1132 Return list of structs: … … 1134 1134 [ 1135 1135 { 1136 geni_sliver_urn ,1137 geni_allocation_status ,1138 geni_expires <time when the sliver expires from its current state>,1136 geni_sliver_urn: <string>, 1137 geni_allocation_status: <string>, 1138 geni_expires: <time when the sliver expires from its current state>, 1139 1139 <others AM or method specific> 1140 1140 }, … … 1152 1152 credentials = [ 1153 1153 { 1154 geni_type =<string>,1155 geni_version =<string>,1156 geni_value =<string>,1154 geni_type: <string>, 1155 geni_version: <string>, 1156 geni_value: <string>, 1157 1157 <others> 1158 1158 } … … 1163 1163 {{{ 1164 1164 { 1165 stringgeni_urn: <slice URN>1166 string geni_allocation_status: provisioned (optional field)1167 string geni_operational_status: ready (optional field)1165 geni_urn: <slice URN> 1166 [optional: geni_allocation_status: <string, eg provisioned>] 1167 [optional: geni_operational_status: <string, eg ready >] 1168 1168 geni_expires: <datetime of expiration> 1169 1169 struct geni_resources: [ { geni_urn: <sliver URN> 1170 geni_allocation_status: provisioned 1171 geni_operational_status: ready 1172 [optional: 'geni_resource_status' : string] 1170 geni_allocation_status: <string, eg provisioned> 1171 geni_operational_status: <string, eg ready> 1173 1172 geni_expires: <datetime of individual sliver expiration> 1174 geni_error: ''}, 1173 geni_error: <string, eg ''>, 1174 [optional: 'geni_resource_status' : <string>] 1175 }, 1175 1176 { geni_urn: <sliver URN> 1176 geni_allocation_status: provisioned 1177 geni_operational_status: ready 1178 [optional: 'geni_resource_status' : string] 1177 geni_allocation_status: <string, eg provisioned> 1178 geni_operational_status: <string, eg ready> 1179 1179 geni_expires: <datetime of individual sliver expiration> 1180 geni_error: ''} 1180 geni_error: <string, eg ''>, 1181 [optional: 'geni_resource_status' : <string>] 1182 } 1181 1183 ] 1182 1184 } … … 1192 1194 credentials = [ 1193 1195 { 1194 geni_type =<string>,1195 geni_version =<string>,1196 geni_value =<string>,1196 geni_type: <string>, 1197 geni_version: <string>, 1198 geni_value: <string>, 1197 1199 <others> 1198 1200 } … … 1200 1202 }}} 1201 1203 1202 Options include: {{{geni_best_effort = True/False, default false}}}1204 Options include: {{{geni_best_effort: <True/False, default false>}}} 1203 1205 1204 1206 Return list of structs: 1205 1207 {{{ 1206 1208 [ { 1207 'geni_urn' : string,1208 'geni_operational_status' : string,1209 [optional: 'geni_resource_status' : string]1209 geni_urn : <string>, 1210 geni_operational_status : <string>, 1211 [optional: geni_resource_status' : <string>] 1210 1212 }, 1211 1213 ... … … 1223 1225 credentials = [ 1224 1226 { 1225 geni_type =<string>,1226 geni_version =<string>,1227 geni_value =<string>,1227 geni_type: <string>, 1228 geni_version: <string>, 1229 geni_value: <string>, 1228 1230 <others> 1229 1231 } … … 1231 1233 }}} 1232 1234 1233 Options include: {{{geni_best_effort = True/False, default false}}}1235 Options include: {{{geni_best_effort: <True/False, default false>}}} 1234 1236 1235 1237 Return list of structs: … … 1237 1239 [ 1238 1240 { 1239 geni_sliver_urn ,1240 geni_allocation_status ,1241 geni_expires <time when the sliver expires from its current state>,1241 geni_sliver_urn: <string>, 1242 geni_allocation_status: <string>, 1243 geni_expires: <time when the sliver expires from its current state>, 1242 1244 <others AM or method specific> 1243 1245 }, … … 1255 1257 credentials = [ 1256 1258 { 1257 geni_type =<string>,1258 geni_version =<string>,1259 geni_value =<string>,1259 geni_type: <string>, 1260 geni_version: <string>, 1261 geni_value: <string>, 1260 1262 <others> 1261 1263 } … … 1267 1269 [ 1268 1270 { 1269 geni_sliver_urn ,1270 geni_allocation_status ,1271 geni_expires <time when the sliver expires from its current state>,1271 geni_sliver_urn: <string>, 1272 geni_allocation_status: <string>, 1273 geni_expires: <time when the sliver expires from its current state>, 1272 1274 <others AM or method specific> 1273 1275 },