xml_utils.py 64 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564
  1. # -*- coding: utf-8 -*-
  2. """
  3. oss2.xml_utils
  4. ~~~~~~~~~~~~~~
  5. XML处理相关。
  6. 主要包括两类接口:
  7. - parse_开头的函数:用来解析服务器端返回的XML
  8. - to_开头的函数:用来生成发往服务器端的XML
  9. """
  10. import logging
  11. import xml.etree.ElementTree as ElementTree
  12. from .models import (SimplifiedObjectInfo,
  13. SimplifiedBucketInfo,
  14. PartInfo,
  15. MultipartUploadInfo,
  16. LifecycleRule,
  17. LifecycleExpiration,
  18. CorsRule,
  19. LiveChannelInfoTarget,
  20. LiveChannelInfo,
  21. LiveRecord,
  22. LiveChannelVideoStat,
  23. LiveChannelAudioStat,
  24. Owner,
  25. AccessControlList,
  26. AbortMultipartUpload,
  27. StorageTransition,
  28. Tagging,
  29. TaggingRule,
  30. ServerSideEncryptionRule,
  31. ListObjectVersionsResult,
  32. ObjectVersionInfo,
  33. DeleteMarkerInfo,
  34. BatchDeleteObjectVersionResult,
  35. BucketWebsite,
  36. RoutingRule,
  37. Condition,
  38. ConditionInlcudeHeader,
  39. Redirect,
  40. RedirectMirrorHeaders,
  41. MirrorHeadersSet,
  42. REDIRECT_TYPE_MIRROR,
  43. REDIRECT_TYPE_EXTERNAL,
  44. REDIRECT_TYPE_INTERNAL,
  45. REDIRECT_TYPE_ALICDN,
  46. NoncurrentVersionStorageTransition,
  47. NoncurrentVersionExpiration,
  48. AsyncFetchTaskConfiguration,
  49. InventoryConfiguration,
  50. InventoryFilter,
  51. InventorySchedule,
  52. InventoryDestination,
  53. InventoryBucketDestination,
  54. InventoryServerSideEncryptionKMS,
  55. InventoryServerSideEncryptionOSS)
  56. from .select_params import (SelectJsonTypes, SelectParameters)
  57. from .compat import urlunquote, to_unicode, to_string
  58. from .utils import iso8601_to_unixtime, date_to_iso8601, iso8601_to_date
  59. from . import utils
  60. import base64
  61. from .exceptions import SelectOperationClientError
  62. logger = logging.getLogger(__name__)
  63. def _find_tag(parent, path):
  64. child = parent.find(path)
  65. if child is None:
  66. raise RuntimeError("parse xml: " + path + " could not be found under " + parent.tag)
  67. if child.text is None:
  68. return ''
  69. return to_string(child.text)
  70. def _find_tag_with_default(parent, path, default_value):
  71. child = parent.find(path)
  72. if child is None:
  73. return default_value
  74. if child.text is None:
  75. return ''
  76. return to_string(child.text)
  77. def _find_bool(parent, path):
  78. text = _find_tag(parent, path)
  79. if text == 'true':
  80. return True
  81. elif text == 'false':
  82. return False
  83. else:
  84. raise RuntimeError("parse xml: value of " + path + " is not a boolean under " + parent.tag)
  85. def _find_int(parent, path):
  86. return int(_find_tag(parent, path))
  87. def _find_object(parent, path, url_encoded):
  88. name = _find_tag(parent, path)
  89. if url_encoded:
  90. return urlunquote(name)
  91. else:
  92. return name
  93. def _find_all_tags(parent, tag):
  94. return [to_string(node.text) or '' for node in parent.findall(tag)]
  95. def _is_url_encoding(root):
  96. node = root.find('EncodingType')
  97. if node is not None and to_string(node.text) == 'url':
  98. return True
  99. else:
  100. return False
  101. def _node_to_string(root):
  102. return ElementTree.tostring(root, encoding='utf-8')
  103. def _add_node_list(parent, tag, entries):
  104. for e in entries:
  105. _add_text_child(parent, tag, e)
  106. def _add_text_child(parent, tag, text):
  107. ElementTree.SubElement(parent, tag).text = to_unicode(text)
  108. def _add_node_child(parent, tag):
  109. return ElementTree.SubElement(parent, tag)
  110. def parse_list_objects(result, body):
  111. root = ElementTree.fromstring(body)
  112. url_encoded = _is_url_encoding(root)
  113. result.is_truncated = _find_bool(root, 'IsTruncated')
  114. if result.is_truncated:
  115. result.next_marker = _find_object(root, 'NextMarker', url_encoded)
  116. for contents_node in root.findall('Contents'):
  117. owner = None
  118. if contents_node.find("Owner") is not None:
  119. owner = Owner(_find_tag(contents_node, 'Owner/DisplayName'), _find_tag(contents_node, 'Owner/ID'))
  120. result.object_list.append(SimplifiedObjectInfo(
  121. _find_object(contents_node, 'Key', url_encoded),
  122. iso8601_to_unixtime(_find_tag(contents_node, 'LastModified')),
  123. _find_tag(contents_node, 'ETag').strip('"'),
  124. _find_tag(contents_node, 'Type'),
  125. int(_find_tag(contents_node, 'Size')),
  126. _find_tag(contents_node, 'StorageClass'),
  127. owner
  128. ))
  129. for prefix_node in root.findall('CommonPrefixes'):
  130. result.prefix_list.append(_find_object(prefix_node, 'Prefix', url_encoded))
  131. return result
  132. def parse_list_objects_v2(result, body):
  133. root = ElementTree.fromstring(body)
  134. url_encoded = _is_url_encoding(root)
  135. result.is_truncated = _find_bool(root, 'IsTruncated')
  136. if result.is_truncated:
  137. result.next_continuation_token = _find_object(root, 'NextContinuationToken', url_encoded)
  138. for contents_node in root.findall('Contents'):
  139. owner = None
  140. if contents_node.find("Owner") is not None:
  141. owner = Owner(_find_tag(contents_node, 'Owner/DisplayName'), _find_tag(contents_node, 'Owner/ID'))
  142. result.object_list.append(SimplifiedObjectInfo(
  143. _find_object(contents_node, 'Key', url_encoded),
  144. iso8601_to_unixtime(_find_tag(contents_node, 'LastModified')),
  145. _find_tag(contents_node, 'ETag').strip('"'),
  146. _find_tag(contents_node, 'Type'),
  147. int(_find_tag(contents_node, 'Size')),
  148. _find_tag(contents_node, 'StorageClass'),
  149. owner
  150. ))
  151. for prefix_node in root.findall('CommonPrefixes'):
  152. result.prefix_list.append(_find_object(prefix_node, 'Prefix', url_encoded))
  153. return result
  154. def parse_list_buckets(result, body):
  155. root = ElementTree.fromstring(body)
  156. if root.find('IsTruncated') is None:
  157. result.is_truncated = False
  158. else:
  159. result.is_truncated = _find_bool(root, 'IsTruncated')
  160. if result.is_truncated:
  161. result.next_marker = _find_tag(root, 'NextMarker')
  162. for bucket_node in root.findall('Buckets/Bucket'):
  163. result.buckets.append(SimplifiedBucketInfo(
  164. _find_tag(bucket_node, 'Name'),
  165. _find_tag(bucket_node, 'Location'),
  166. iso8601_to_unixtime(_find_tag(bucket_node, 'CreationDate')),
  167. _find_tag(bucket_node, 'ExtranetEndpoint'),
  168. _find_tag(bucket_node, 'IntranetEndpoint'),
  169. _find_tag(bucket_node, 'StorageClass')
  170. ))
  171. return result
  172. def parse_init_multipart_upload(result, body):
  173. root = ElementTree.fromstring(body)
  174. result.upload_id = _find_tag(root, 'UploadId')
  175. return result
  176. def parse_list_multipart_uploads(result, body):
  177. root = ElementTree.fromstring(body)
  178. url_encoded = _is_url_encoding(root)
  179. result.is_truncated = _find_bool(root, 'IsTruncated')
  180. result.next_key_marker = _find_object(root, 'NextKeyMarker', url_encoded)
  181. result.next_upload_id_marker = _find_tag(root, 'NextUploadIdMarker')
  182. for upload_node in root.findall('Upload'):
  183. result.upload_list.append(MultipartUploadInfo(
  184. _find_object(upload_node, 'Key', url_encoded),
  185. _find_tag(upload_node, 'UploadId'),
  186. iso8601_to_unixtime(_find_tag(upload_node, 'Initiated'))
  187. ))
  188. for prefix_node in root.findall('CommonPrefixes'):
  189. result.prefix_list.append(_find_object(prefix_node, 'Prefix', url_encoded))
  190. return result
  191. def parse_list_parts(result, body):
  192. root = ElementTree.fromstring(body)
  193. result.is_truncated = _find_bool(root, 'IsTruncated')
  194. result.next_marker = _find_tag(root, 'NextPartNumberMarker')
  195. for part_node in root.findall('Part'):
  196. result.parts.append(PartInfo(
  197. _find_int(part_node, 'PartNumber'),
  198. _find_tag(part_node, 'ETag').strip('"'),
  199. size=_find_int(part_node, 'Size'),
  200. last_modified=iso8601_to_unixtime(_find_tag(part_node, 'LastModified'))
  201. ))
  202. return result
  203. def parse_batch_delete_objects(result, body):
  204. if not body:
  205. return result
  206. root = ElementTree.fromstring(body)
  207. url_encoded = _is_url_encoding(root)
  208. for deleted_node in root.findall('Deleted'):
  209. key = _find_object(deleted_node, 'Key', url_encoded)
  210. result.deleted_keys.append(key)
  211. versionid_node = deleted_node.find('VersionId')
  212. versionid = None
  213. if versionid_node is not None:
  214. versionid = _find_tag(deleted_node, 'VersionId')
  215. delete_marker_node = deleted_node.find('DeleteMarker')
  216. delete_marker = False
  217. if delete_marker_node is not None:
  218. delete_marker = _find_bool(deleted_node, 'DeleteMarker')
  219. marker_versionid_node = deleted_node.find('DeleteMarkerVersionId')
  220. delete_marker_versionid = ''
  221. if marker_versionid_node is not None:
  222. delete_marker_versionid = _find_tag(deleted_node, 'DeleteMarkerVersionId')
  223. result.delete_versions.append(BatchDeleteObjectVersionResult(key, versionid, delete_marker, delete_marker_versionid))
  224. return result
  225. def parse_get_bucket_acl(result, body):
  226. root = ElementTree.fromstring(body)
  227. result.acl = _find_tag(root, 'AccessControlList/Grant')
  228. return result
  229. def parse_get_object_acl(result, body):
  230. root = ElementTree.fromstring(body)
  231. result.acl = _find_tag(root, 'AccessControlList/Grant')
  232. return result
  233. def parse_get_bucket_location(result, body):
  234. result.location = to_string(ElementTree.fromstring(body).text)
  235. return result
  236. def parse_get_bucket_logging(result, body):
  237. root = ElementTree.fromstring(body)
  238. if root.find('LoggingEnabled/TargetBucket') is not None:
  239. result.target_bucket = _find_tag(root, 'LoggingEnabled/TargetBucket')
  240. if root.find('LoggingEnabled/TargetPrefix') is not None:
  241. result.target_prefix = _find_tag(root, 'LoggingEnabled/TargetPrefix')
  242. return result
  243. def parse_get_bucket_stat(result, body):
  244. root = ElementTree.fromstring(body)
  245. result.storage_size_in_bytes = _find_int(root, 'Storage')
  246. result.object_count = _find_int(root, 'ObjectCount')
  247. result.multi_part_upload_count = _find_int(root, 'MultipartUploadCount')
  248. return result
  249. def parse_get_bucket_info(result, body):
  250. root = ElementTree.fromstring(body)
  251. result.name = _find_tag(root, 'Bucket/Name')
  252. result.creation_date = _find_tag(root, 'Bucket/CreationDate')
  253. result.storage_class = _find_tag(root, 'Bucket/StorageClass')
  254. result.extranet_endpoint = _find_tag(root, 'Bucket/ExtranetEndpoint')
  255. result.intranet_endpoint = _find_tag(root, 'Bucket/IntranetEndpoint')
  256. result.location = _find_tag(root, 'Bucket/Location')
  257. result.owner = Owner(_find_tag(root, 'Bucket/Owner/DisplayName'), _find_tag(root, 'Bucket/Owner/ID'))
  258. result.acl = AccessControlList(_find_tag(root, 'Bucket/AccessControlList/Grant'))
  259. result.comment = _find_tag_with_default(root, 'Bucket/Comment', None)
  260. result.versioning_status = _find_tag_with_default(root, 'Bucket/Versioning', None)
  261. result.data_redundancy_type = _find_tag_with_default(root, 'Bucket/DataRedundancyType', None)
  262. server_side_encryption = root.find("Bucket/ServerSideEncryptionRule")
  263. if server_side_encryption is None:
  264. result.bucket_encryption_rule = None
  265. else:
  266. result.bucket_encryption_rule = _parse_bucket_encryption_info(server_side_encryption)
  267. return result
  268. def _parse_bucket_encryption_info(node):
  269. rule = ServerSideEncryptionRule()
  270. rule.sse_algorithm = _find_tag(node,"SSEAlgorithm")
  271. if rule.sse_algorithm == "None":
  272. rule.kms_master_keyid = None
  273. rule.sse_algorithm = None
  274. return rule
  275. kmsnode = node.find("KMSMasterKeyID")
  276. if kmsnode is None or kmsnode.text is None:
  277. rule.kms_master_keyid = None
  278. else:
  279. rule.kms_master_keyid = to_string(kmsnode.text)
  280. kms_data_encryption_node = node.find("KMSDataEncryption")
  281. if kms_data_encryption_node is None or kms_data_encryption_node.text is None:
  282. rule.kms_data_encryption = None
  283. else:
  284. rule.kms_data_encryption = to_string(kms_data_encryption_node.text)
  285. return rule
  286. def parse_get_bucket_referer(result, body):
  287. root = ElementTree.fromstring(body)
  288. result.allow_empty_referer = _find_bool(root, 'AllowEmptyReferer')
  289. result.referers = _find_all_tags(root, 'RefererList/Referer')
  290. return result
  291. def parse_condition_include_header(include_header_node):
  292. key = _find_tag(include_header_node, 'Key')
  293. equals = _find_tag(include_header_node, 'Equals')
  294. include_header = ConditionInlcudeHeader(key, equals)
  295. return include_header
  296. def parse_routing_rule_condition(condition_node):
  297. if condition_node.find('KeyPrefixEquals') is not None:
  298. key_prefix_equals = _find_tag(condition_node, 'KeyPrefixEquals')
  299. if condition_node.find('HttpErrorCodeReturnedEquals') is not None:
  300. http_err_code_return_equals = _find_int(condition_node, 'HttpErrorCodeReturnedEquals');
  301. include_header_list = []
  302. if condition_node.find('IncludeHeader') is not None:
  303. for include_header_node in condition_node.findall('IncludeHeader'):
  304. include_header = parse_condition_include_header(include_header_node)
  305. include_header_list.append(include_header)
  306. condition = Condition(key_prefix_equals, http_err_code_return_equals, include_header_list)
  307. return condition
  308. def parse_mirror_headers(mirror_headers_node):
  309. if mirror_headers_node is None:
  310. return None
  311. pass_all = None
  312. if mirror_headers_node.find('PassAll') is not None:
  313. pass_all = _find_bool(mirror_headers_node, 'PassAll')
  314. pass_list = _find_all_tags(mirror_headers_node, 'Pass')
  315. remove_list = _find_all_tags(mirror_headers_node, 'Remove')
  316. set_list = []
  317. for set_node in mirror_headers_node.findall('Set'):
  318. key = _find_tag(set_node, 'Key')
  319. value = _find_tag(set_node, 'Value')
  320. mirror_headers_set = MirrorHeadersSet(key, value)
  321. set_list.append(mirror_headers_set)
  322. redirect_mirror_headers = RedirectMirrorHeaders(pass_all, pass_list, remove_list, set_list)
  323. return redirect_mirror_headers
  324. def parse_routing_rule_redirect(redirect_node):
  325. redirect_type = None
  326. pass_query_string = None
  327. replace_key_with = None
  328. replace_key_prefix_with = None
  329. proto = None
  330. host_name = None
  331. http_redirect_code = None
  332. mirror_url = None
  333. mirror_url_slave = None
  334. mirror_url_probe = None
  335. mirror_pass_query_string = None
  336. mirror_check_md5 = None
  337. mirror_follow_redirect = None
  338. mirror_headers = None
  339. # common args
  340. redirect_type = _find_tag(redirect_node, 'RedirectType')
  341. if redirect_node.find('PassQueryString') is not None:
  342. pass_query_string = _find_bool(redirect_node, 'PassQueryString')
  343. # External, AliCDN
  344. if redirect_type in [REDIRECT_TYPE_EXTERNAL, REDIRECT_TYPE_ALICDN]:
  345. if redirect_node.find('Protocol') is not None:
  346. proto = _find_tag(redirect_node, 'Protocol')
  347. if redirect_node.find('HostName') is not None:
  348. host_name = _find_tag(redirect_node, 'HostName')
  349. if redirect_node.find('HttpRedirectCode') is not None:
  350. http_redirect_code = _find_int(redirect_node, 'HttpRedirectCode')
  351. # External, AliCDN, Internal
  352. if redirect_type in [REDIRECT_TYPE_EXTERNAL, REDIRECT_TYPE_ALICDN, REDIRECT_TYPE_INTERNAL]:
  353. if redirect_node.find('ReplaceKeyWith') is not None:
  354. replace_key_with = _find_tag(redirect_node, 'ReplaceKeyWith')
  355. if redirect_node.find('ReplaceKeyPrefixWith') is not None:
  356. replace_key_prefix_with = _find_tag(redirect_node, 'ReplaceKeyPrefixWith')
  357. # Mirror
  358. elif redirect_type == REDIRECT_TYPE_MIRROR:
  359. if redirect_node.find('MirrorURL') is not None:
  360. mirror_url = _find_tag(redirect_node, 'MirrorURL')
  361. if redirect_node.find('MirrorURLSlave') is not None:
  362. mirror_url_slave = _find_tag(redirect_node, 'MirrorURLSlave')
  363. if redirect_node.find('MirrorURLProbe') is not None:
  364. mirror_url_probe = _find_tag(redirect_node, 'MirrorURLProbe')
  365. if redirect_node.find('MirrorPassQueryString') is not None:
  366. mirror_pass_query_string = _find_bool(redirect_node, 'MirrorPassQueryString')
  367. if redirect_node.find('MirrorCheckMd5') is not None:
  368. mirror_check_md5 = _find_bool(redirect_node, 'MirrorCheckMd5')
  369. if redirect_node.find('MirrorFollowRedirect') is not None:
  370. mirror_follow_redirect = _find_bool(redirect_node, 'MirrorFollowRedirect')
  371. mirror_headers = parse_mirror_headers(redirect_node.find('MirrorHeaders'))
  372. redirect = Redirect(redirect_type=redirect_type, proto=proto, host_name=host_name, replace_key_with=replace_key_with,
  373. replace_key_prefix_with=replace_key_prefix_with, http_redirect_code=http_redirect_code,
  374. pass_query_string=pass_query_string, mirror_url=mirror_url,mirror_url_slave=mirror_url_slave,
  375. mirror_url_probe=mirror_url_probe, mirror_pass_query_string=mirror_pass_query_string,
  376. mirror_follow_redirect=mirror_follow_redirect, mirror_check_md5=mirror_check_md5,
  377. mirror_headers=mirror_headers)
  378. return redirect
  379. def parse_get_bucket_website(result, body):
  380. root = ElementTree.fromstring(body)
  381. result.index_file = _find_tag(root, 'IndexDocument/Suffix')
  382. result.error_file = _find_tag(root, 'ErrorDocument/Key')
  383. if root.find('RoutingRules') is None:
  384. return result
  385. routing_rules_node = root.find('RoutingRules')
  386. for rule_node in routing_rules_node.findall('RoutingRule'):
  387. rule_num = _find_int(rule_node, 'RuleNumber')
  388. condition = parse_routing_rule_condition(rule_node.find('Condition'))
  389. redirect = parse_routing_rule_redirect(rule_node.find('Redirect'))
  390. rule = RoutingRule(rule_num, condition, redirect);
  391. result.rules.append(rule)
  392. return result
  393. def parse_create_live_channel(result, body):
  394. root = ElementTree.fromstring(body)
  395. result.play_url = _find_tag(root, 'PlayUrls/Url')
  396. result.publish_url = _find_tag(root, 'PublishUrls/Url')
  397. return result
  398. def parse_get_live_channel(result, body):
  399. root = ElementTree.fromstring(body)
  400. result.status = _find_tag(root, 'Status')
  401. result.description = _find_tag(root, 'Description')
  402. target = LiveChannelInfoTarget()
  403. target.type = _find_tag(root, 'Target/Type')
  404. target.frag_duration = _find_tag(root, 'Target/FragDuration')
  405. target.frag_count = _find_tag(root, 'Target/FragCount')
  406. target.playlist_name = _find_tag(root, 'Target/PlaylistName')
  407. result.target = target
  408. return result
  409. def parse_list_live_channel(result, body):
  410. root = ElementTree.fromstring(body)
  411. result.prefix = _find_tag(root, 'Prefix')
  412. result.marker = _find_tag(root, 'Marker')
  413. result.max_keys = _find_int(root, 'MaxKeys')
  414. result.is_truncated = _find_bool(root, 'IsTruncated')
  415. if result.is_truncated:
  416. result.next_marker = _find_tag(root, 'NextMarker')
  417. channels = root.findall('LiveChannel')
  418. for channel in channels:
  419. tmp = LiveChannelInfo()
  420. tmp.name = _find_tag(channel, 'Name')
  421. tmp.description = _find_tag(channel, 'Description')
  422. tmp.status = _find_tag(channel, 'Status')
  423. tmp.last_modified = iso8601_to_unixtime(_find_tag(channel, 'LastModified'))
  424. tmp.play_url = _find_tag(channel, 'PlayUrls/Url')
  425. tmp.publish_url = _find_tag(channel, 'PublishUrls/Url')
  426. result.channels.append(tmp)
  427. return result
  428. def parse_stat_video(video_node, video):
  429. video.width = _find_int(video_node, 'Width')
  430. video.height = _find_int(video_node, 'Height')
  431. video.frame_rate = _find_int(video_node, 'FrameRate')
  432. video.bandwidth = _find_int(video_node, 'Bandwidth')
  433. video.codec = _find_tag(video_node, 'Codec')
  434. def parse_stat_audio(audio_node, audio):
  435. audio.bandwidth = _find_int(audio_node, 'Bandwidth')
  436. audio.sample_rate = _find_int(audio_node, 'SampleRate')
  437. audio.codec = _find_tag(audio_node, 'Codec')
  438. def parse_live_channel_stat(result, body):
  439. root = ElementTree.fromstring(body)
  440. result.status = _find_tag(root, 'Status')
  441. if root.find('RemoteAddr') is not None:
  442. result.remote_addr = _find_tag(root, 'RemoteAddr')
  443. if root.find('ConnectedTime') is not None:
  444. result.connected_time = iso8601_to_unixtime(_find_tag(root, 'ConnectedTime'))
  445. video_node = root.find('Video')
  446. audio_node = root.find('Audio')
  447. if video_node is not None:
  448. result.video = LiveChannelVideoStat()
  449. parse_stat_video(video_node, result.video)
  450. if audio_node is not None:
  451. result.audio = LiveChannelAudioStat()
  452. parse_stat_audio(audio_node, result.audio)
  453. return result
  454. def parse_live_channel_history(result, body):
  455. root = ElementTree.fromstring(body)
  456. records = root.findall('LiveRecord')
  457. for record in records:
  458. tmp = LiveRecord()
  459. tmp.start_time = iso8601_to_unixtime(_find_tag(record, 'StartTime'))
  460. tmp.end_time = iso8601_to_unixtime(_find_tag(record, 'EndTime'))
  461. tmp.remote_addr = _find_tag(record, 'RemoteAddr')
  462. result.records.append(tmp)
  463. return result
  464. def parse_lifecycle_expiration(expiration_node):
  465. if expiration_node is None:
  466. return None
  467. expiration = LifecycleExpiration()
  468. if expiration_node.find('Days') is not None:
  469. expiration.days = _find_int(expiration_node, 'Days')
  470. elif expiration_node.find('Date') is not None:
  471. expiration.date = iso8601_to_date(_find_tag(expiration_node, 'Date'))
  472. elif expiration_node.find('CreatedBeforeDate') is not None:
  473. expiration.created_before_date = iso8601_to_date(_find_tag(expiration_node, 'CreatedBeforeDate'))
  474. elif expiration_node.find('ExpiredObjectDeleteMarker') is not None:
  475. expiration.expired_detete_marker = _find_bool(expiration_node, 'ExpiredObjectDeleteMarker')
  476. return expiration
  477. def parse_lifecycle_abort_multipart_upload(abort_multipart_upload_node):
  478. if abort_multipart_upload_node is None:
  479. return None
  480. abort_multipart_upload = AbortMultipartUpload()
  481. if abort_multipart_upload_node.find('Days') is not None:
  482. abort_multipart_upload.days = _find_int(abort_multipart_upload_node, 'Days')
  483. elif abort_multipart_upload_node.find('CreatedBeforeDate') is not None:
  484. abort_multipart_upload.created_before_date = iso8601_to_date(_find_tag(abort_multipart_upload_node,
  485. 'CreatedBeforeDate'))
  486. return abort_multipart_upload
  487. def parse_lifecycle_storage_transitions(storage_transition_nodes):
  488. storage_transitions = []
  489. for storage_transition_node in storage_transition_nodes:
  490. storage_class = _find_tag(storage_transition_node, 'StorageClass')
  491. storage_transition = StorageTransition(storage_class=storage_class)
  492. if storage_transition_node.find('Days') is not None:
  493. storage_transition.days = _find_int(storage_transition_node, 'Days')
  494. elif storage_transition_node.find('CreatedBeforeDate') is not None:
  495. storage_transition.created_before_date = iso8601_to_date(_find_tag(storage_transition_node,
  496. 'CreatedBeforeDate'))
  497. storage_transitions.append(storage_transition)
  498. return storage_transitions
  499. def parse_lifecycle_object_taggings(lifecycle_tagging_nodes):
  500. if lifecycle_tagging_nodes is None or \
  501. len(lifecycle_tagging_nodes) == 0:
  502. return None
  503. tagging_rule = TaggingRule()
  504. for tag_node in lifecycle_tagging_nodes:
  505. key = _find_tag(tag_node, 'Key')
  506. value = _find_tag(tag_node, 'Value')
  507. tagging_rule.add(key, value)
  508. return Tagging(tagging_rule)
  509. def parse_lifecycle_version_expiration(version_expiration_node):
  510. if version_expiration_node is None:
  511. return None
  512. noncurrent_days = _find_int(version_expiration_node, 'NoncurrentDays')
  513. expiration = NoncurrentVersionExpiration(noncurrent_days)
  514. return expiration
  515. def parse_lifecycle_verison_storage_transitions(version_storage_transition_nodes):
  516. version_storage_transitions = []
  517. for transition_node in version_storage_transition_nodes:
  518. storage_class = _find_tag(transition_node, 'StorageClass')
  519. non_crurrent_days = _find_int(transition_node, 'NoncurrentDays')
  520. version_storage_transition = NoncurrentVersionStorageTransition(non_crurrent_days, storage_class)
  521. version_storage_transitions.append(version_storage_transition)
  522. return version_storage_transitions
  523. def parse_get_bucket_lifecycle(result, body):
  524. root = ElementTree.fromstring(body)
  525. url_encoded = _is_url_encoding(root)
  526. for rule_node in root.findall('Rule'):
  527. expiration = parse_lifecycle_expiration(rule_node.find('Expiration'))
  528. abort_multipart_upload = parse_lifecycle_abort_multipart_upload(rule_node.find('AbortMultipartUpload'))
  529. storage_transitions = parse_lifecycle_storage_transitions(rule_node.findall('Transition'))
  530. tagging = parse_lifecycle_object_taggings(rule_node.findall('Tag'))
  531. noncurrent_version_expiration = parse_lifecycle_version_expiration(rule_node.find('NoncurrentVersionExpiration'))
  532. noncurrent_version_sotrage_transitions = parse_lifecycle_verison_storage_transitions(rule_node.findall('NoncurrentVersionTransition'))
  533. rule = LifecycleRule(
  534. _find_tag(rule_node, 'ID'),
  535. _find_tag(rule_node, 'Prefix'),
  536. status=_find_tag(rule_node, 'Status'),
  537. expiration=expiration,
  538. abort_multipart_upload=abort_multipart_upload,
  539. storage_transitions=storage_transitions,
  540. tagging=tagging,
  541. noncurrent_version_expiration = noncurrent_version_expiration,
  542. noncurrent_version_sotrage_transitions = noncurrent_version_sotrage_transitions
  543. )
  544. result.rules.append(rule)
  545. return result
  546. def parse_get_bucket_cors(result, body):
  547. root = ElementTree.fromstring(body)
  548. for rule_node in root.findall('CORSRule'):
  549. rule = CorsRule()
  550. rule.allowed_origins = _find_all_tags(rule_node, 'AllowedOrigin')
  551. rule.allowed_methods = _find_all_tags(rule_node, 'AllowedMethod')
  552. rule.allowed_headers = _find_all_tags(rule_node, 'AllowedHeader')
  553. rule.expose_headers = _find_all_tags(rule_node, 'ExposeHeader')
  554. max_age_node = rule_node.find('MaxAgeSeconds')
  555. if max_age_node is not None:
  556. rule.max_age_seconds = int(max_age_node.text)
  557. result.rules.append(rule)
  558. return result
  559. def to_complete_upload_request(parts):
  560. root = ElementTree.Element('CompleteMultipartUpload')
  561. for p in parts:
  562. part_node = ElementTree.SubElement(root, "Part")
  563. _add_text_child(part_node, 'PartNumber', str(p.part_number))
  564. _add_text_child(part_node, 'ETag', '"{0}"'.format(p.etag))
  565. return _node_to_string(root)
  566. def to_batch_delete_objects_request(keys, quiet):
  567. root_node = ElementTree.Element('Delete')
  568. _add_text_child(root_node, 'Quiet', str(quiet).lower())
  569. for key in keys:
  570. object_node = ElementTree.SubElement(root_node, 'Object')
  571. _add_text_child(object_node, 'Key', key)
  572. return _node_to_string(root_node)
  573. def to_batch_delete_objects_version_request(objectVersions, quiet):
  574. root_node = ElementTree.Element('Delete')
  575. _add_text_child(root_node, 'Quiet', str(quiet).lower())
  576. objectVersionList = objectVersions.object_version_list
  577. for ver in objectVersionList:
  578. object_node = ElementTree.SubElement(root_node, 'Object')
  579. _add_text_child(object_node, 'Key', ver.key)
  580. if ver.versionid != '':
  581. _add_text_child(object_node, 'VersionId', ver.versionid)
  582. return _node_to_string(root_node)
  583. def to_put_bucket_config(bucket_config):
  584. root = ElementTree.Element('CreateBucketConfiguration')
  585. _add_text_child(root, 'StorageClass', bucket_config.storage_class)
  586. if bucket_config.data_redundancy_type is not None:
  587. _add_text_child(root, 'DataRedundancyType', bucket_config.data_redundancy_type)
  588. return _node_to_string(root)
  589. def to_put_bucket_logging(bucket_logging):
  590. root = ElementTree.Element('BucketLoggingStatus')
  591. if bucket_logging.target_bucket:
  592. logging_node = ElementTree.SubElement(root, 'LoggingEnabled')
  593. _add_text_child(logging_node, 'TargetBucket', bucket_logging.target_bucket)
  594. _add_text_child(logging_node, 'TargetPrefix', bucket_logging.target_prefix)
  595. return _node_to_string(root)
  596. def to_put_bucket_referer(bucket_referer):
  597. root = ElementTree.Element('RefererConfiguration')
  598. _add_text_child(root, 'AllowEmptyReferer', str(bucket_referer.allow_empty_referer).lower())
  599. list_node = ElementTree.SubElement(root, 'RefererList')
  600. for r in bucket_referer.referers:
  601. _add_text_child(list_node, 'Referer', r)
  602. return _node_to_string(root)
  603. def to_put_bucket_website(bucket_website):
  604. root = ElementTree.Element('WebsiteConfiguration')
  605. index_node = ElementTree.SubElement(root, 'IndexDocument')
  606. _add_text_child(index_node, 'Suffix', bucket_website.index_file)
  607. error_node = ElementTree.SubElement(root, 'ErrorDocument')
  608. _add_text_child(error_node, 'Key', bucket_website.error_file)
  609. if len(bucket_website.rules) == 0:
  610. return _node_to_string(root)
  611. rules_node = ElementTree.SubElement(root, "RoutingRules")
  612. for rule in bucket_website.rules:
  613. rule_node = ElementTree.SubElement(rules_node, 'RoutingRule')
  614. _add_text_child(rule_node, 'RuleNumber', str(rule.rule_num))
  615. condition_node = ElementTree.SubElement(rule_node, 'Condition')
  616. if rule.condition.key_prefix_equals is not None:
  617. _add_text_child(condition_node, 'KeyPrefixEquals', rule.condition.key_prefix_equals)
  618. if rule.condition.http_err_code_return_equals is not None:
  619. _add_text_child(condition_node, 'HttpErrorCodeReturnedEquals',
  620. str(rule.condition.http_err_code_return_equals))
  621. for header in rule.condition.include_header_list:
  622. include_header_node = ElementTree.SubElement(condition_node, 'IncludeHeader')
  623. _add_text_child(include_header_node, 'Key', header.key)
  624. _add_text_child(include_header_node, 'Equals', header.equals)
  625. if rule.redirect is not None:
  626. redirect_node = ElementTree.SubElement(rule_node, 'Redirect')
  627. # common
  628. _add_text_child(redirect_node, 'RedirectType', rule.redirect.redirect_type)
  629. if rule.redirect.pass_query_string is not None:
  630. _add_text_child(redirect_node, 'PassQueryString', str(rule.redirect.pass_query_string))
  631. # External, AliCDN
  632. if rule.redirect.redirect_type in [REDIRECT_TYPE_EXTERNAL, REDIRECT_TYPE_ALICDN]:
  633. if rule.redirect.proto is not None:
  634. _add_text_child(redirect_node, 'Protocol', rule.redirect.proto)
  635. if rule.redirect.host_name is not None:
  636. _add_text_child(redirect_node, 'HostName', rule.redirect.host_name)
  637. if rule.redirect.http_redirect_code is not None:
  638. _add_text_child(redirect_node, 'HttpRedirectCode', str(rule.redirect.http_redirect_code))
  639. # External, AliCDN, Internal
  640. if rule.redirect.redirect_type in [REDIRECT_TYPE_EXTERNAL, REDIRECT_TYPE_ALICDN, REDIRECT_TYPE_INTERNAL]:
  641. if rule.redirect.replace_key_with is not None:
  642. _add_text_child(redirect_node, 'ReplaceKeyWith', rule.redirect.replace_key_with)
  643. if rule.redirect.replace_key_prefix_with is not None:
  644. _add_text_child(redirect_node, 'ReplaceKeyPrefixWith', rule.redirect.replace_key_prefix_with)
  645. # Mirror
  646. elif rule.redirect.redirect_type == REDIRECT_TYPE_MIRROR:
  647. if rule.redirect.mirror_url is not None:
  648. _add_text_child(redirect_node, 'MirrorURL', rule.redirect.mirror_url)
  649. if rule.redirect.mirror_url_slave is not None:
  650. _add_text_child(redirect_node, 'MirrorURLSlave', rule.redirect.mirror_url_slave)
  651. if rule.redirect.mirror_url_probe is not None:
  652. _add_text_child(redirect_node, 'MirrorURLProbe', rule.redirect.mirror_url_probe)
  653. if rule.redirect.mirror_pass_query_string is not None:
  654. _add_text_child(redirect_node, 'MirrorPassQueryString', str(rule.redirect.mirror_pass_query_string))
  655. if rule.redirect.mirror_follow_redirect is not None:
  656. _add_text_child(redirect_node, 'MirrorFollowRedirect', str(rule.redirect.mirror_follow_redirect))
  657. if rule.redirect.mirror_check_md5 is not None:
  658. _add_text_child(redirect_node, 'MirrorCheckMd5', str(rule.redirect.mirror_check_md5))
  659. if rule.redirect.mirror_headers is not None:
  660. mirror_headers_node = ElementTree.SubElement(redirect_node, 'MirrorHeaders')
  661. if rule.redirect.mirror_headers.pass_all is not None:
  662. _add_text_child(mirror_headers_node, 'PassAll', str(rule.redirect.mirror_headers.pass_all))
  663. for pass_param in rule.redirect.mirror_headers.pass_list:
  664. _add_text_child(mirror_headers_node, 'Pass', pass_param)
  665. for remove_param in rule.redirect.mirror_headers.remove_list:
  666. _add_text_child(mirror_headers_node, 'Remove', remove_param)
  667. for set_param in rule.redirect.mirror_headers.set_list:
  668. set_node = ElementTree.SubElement(mirror_headers_node, 'Set')
  669. _add_text_child(set_node, 'Key', set_param.key)
  670. _add_text_child(set_node, 'Value', set_param.value)
  671. return _node_to_string(root)
  672. def to_put_bucket_lifecycle(bucket_lifecycle):
  673. root = ElementTree.Element('LifecycleConfiguration')
  674. for rule in bucket_lifecycle.rules:
  675. rule_node = ElementTree.SubElement(root, 'Rule')
  676. _add_text_child(rule_node, 'ID', rule.id)
  677. _add_text_child(rule_node, 'Prefix', rule.prefix)
  678. _add_text_child(rule_node, 'Status', rule.status)
  679. expiration = rule.expiration
  680. if expiration:
  681. expiration_node = ElementTree.SubElement(rule_node, 'Expiration')
  682. if expiration.days is not None:
  683. _add_text_child(expiration_node, 'Days', str(expiration.days))
  684. elif expiration.date is not None:
  685. _add_text_child(expiration_node, 'Date', date_to_iso8601(expiration.date))
  686. elif expiration.created_before_date is not None:
  687. _add_text_child(expiration_node, 'CreatedBeforeDate', date_to_iso8601(expiration.created_before_date))
  688. elif expiration.expired_detete_marker is not None:
  689. _add_text_child(expiration_node, 'ExpiredObjectDeleteMarker', str(expiration.expired_detete_marker))
  690. abort_multipart_upload = rule.abort_multipart_upload
  691. if abort_multipart_upload:
  692. abort_multipart_upload_node = ElementTree.SubElement(rule_node, 'AbortMultipartUpload')
  693. if abort_multipart_upload.days is not None:
  694. _add_text_child(abort_multipart_upload_node, 'Days', str(abort_multipart_upload.days))
  695. elif abort_multipart_upload.created_before_date is not None:
  696. _add_text_child(abort_multipart_upload_node, 'CreatedBeforeDate',
  697. date_to_iso8601(abort_multipart_upload.created_before_date))
  698. storage_transitions = rule.storage_transitions
  699. if storage_transitions:
  700. for storage_transition in storage_transitions:
  701. storage_transition_node = ElementTree.SubElement(rule_node, 'Transition')
  702. _add_text_child(storage_transition_node, 'StorageClass', str(storage_transition.storage_class))
  703. if storage_transition.days is not None:
  704. _add_text_child(storage_transition_node, 'Days', str(storage_transition.days))
  705. elif storage_transition.created_before_date is not None:
  706. _add_text_child(storage_transition_node, 'CreatedBeforeDate',
  707. date_to_iso8601(storage_transition.created_before_date))
  708. tagging = rule.tagging
  709. if tagging:
  710. tagging_rule = tagging.tag_set.tagging_rule
  711. for key in tagging.tag_set.tagging_rule:
  712. tag_node = ElementTree.SubElement(rule_node, 'Tag')
  713. _add_text_child(tag_node, 'Key', key)
  714. _add_text_child(tag_node, 'Value', tagging_rule[key])
  715. noncurrent_version_expiration = rule.noncurrent_version_expiration
  716. if noncurrent_version_expiration is not None:
  717. version_expiration_node = ElementTree.SubElement(rule_node, 'NoncurrentVersionExpiration')
  718. _add_text_child(version_expiration_node, 'NoncurrentDays', str(noncurrent_version_expiration.noncurrent_days))
  719. noncurrent_version_sotrage_transitions = rule.noncurrent_version_sotrage_transitions
  720. if noncurrent_version_sotrage_transitions is not None:
  721. for noncurrent_version_sotrage_transition in noncurrent_version_sotrage_transitions:
  722. version_transition_node = ElementTree.SubElement(rule_node, 'NoncurrentVersionTransition')
  723. _add_text_child(version_transition_node, 'NoncurrentDays', str(noncurrent_version_sotrage_transition.noncurrent_days))
  724. _add_text_child(version_transition_node, 'StorageClass', str(noncurrent_version_sotrage_transition.storage_class))
  725. return _node_to_string(root)
  726. def to_put_bucket_cors(bucket_cors):
  727. root = ElementTree.Element('CORSConfiguration')
  728. for rule in bucket_cors.rules:
  729. rule_node = ElementTree.SubElement(root, 'CORSRule')
  730. _add_node_list(rule_node, 'AllowedOrigin', rule.allowed_origins)
  731. _add_node_list(rule_node, 'AllowedMethod', rule.allowed_methods)
  732. _add_node_list(rule_node, 'AllowedHeader', rule.allowed_headers)
  733. _add_node_list(rule_node, 'ExposeHeader', rule.expose_headers)
  734. if rule.max_age_seconds is not None:
  735. _add_text_child(rule_node, 'MaxAgeSeconds', str(rule.max_age_seconds))
  736. return _node_to_string(root)
  737. def to_create_live_channel(live_channel):
  738. root = ElementTree.Element('LiveChannelConfiguration')
  739. _add_text_child(root, 'Description', live_channel.description)
  740. _add_text_child(root, 'Status', live_channel.status)
  741. target_node = _add_node_child(root, 'Target')
  742. _add_text_child(target_node, 'Type', live_channel.target.type)
  743. _add_text_child(target_node, 'FragDuration', str(live_channel.target.frag_duration))
  744. _add_text_child(target_node, 'FragCount', str(live_channel.target.frag_count))
  745. _add_text_child(target_node, 'PlaylistName', str(live_channel.target.playlist_name))
  746. return _node_to_string(root)
  747. def to_select_object(sql, select_params):
  748. if (select_params is not None and 'Json_Type' in select_params):
  749. return to_select_json_object(sql, select_params)
  750. else:
  751. return to_select_csv_object(sql, select_params)
  752. def to_select_csv_object(sql, select_params):
  753. root = ElementTree.Element('SelectRequest')
  754. _add_text_child(root, 'Expression', base64.b64encode(str.encode(sql)))
  755. input_ser = ElementTree.SubElement(root, 'InputSerialization')
  756. output_ser = ElementTree.SubElement(root, 'OutputSerialization')
  757. csv = ElementTree.SubElement(input_ser, 'CSV')
  758. out_csv = ElementTree.SubElement(output_ser, 'CSV')
  759. options = ElementTree.SubElement(root, 'Options')
  760. if (select_params is None):
  761. return _node_to_string(root)
  762. for key, value in select_params.items():
  763. if SelectParameters.CsvHeaderInfo == key:
  764. _add_text_child(csv, 'FileHeaderInfo', value)
  765. elif SelectParameters.CommentCharacter == key:
  766. _add_text_child(csv, SelectParameters.CommentCharacter, base64.b64encode(str.encode(value)))
  767. elif SelectParameters.RecordDelimiter == key:
  768. _add_text_child(csv, SelectParameters.RecordDelimiter, base64.b64encode(str.encode(value)))
  769. elif SelectParameters.OutputRecordDelimiter == key:
  770. _add_text_child(out_csv, SelectParameters.RecordDelimiter, base64.b64encode(str.encode(value)))
  771. elif SelectParameters.FieldDelimiter == key:
  772. _add_text_child(csv, SelectParameters.FieldDelimiter, base64.b64encode(str.encode(value)))
  773. elif SelectParameters.OutputFieldDelimiter == key:
  774. _add_text_child(out_csv, SelectParameters.FieldDelimiter, base64.b64encode(str.encode(value)))
  775. elif SelectParameters.QuoteCharacter == key:
  776. _add_text_child(csv, SelectParameters.QuoteCharacter, base64.b64encode(str.encode(value)))
  777. elif SelectParameters.SplitRange == key:
  778. _add_text_child(csv, 'Range', utils._make_split_range_string(value))
  779. elif SelectParameters.LineRange == key:
  780. _add_text_child(csv, 'Range', utils._make_line_range_string(value))
  781. elif SelectParameters.CompressionType == key:
  782. _add_text_child(input_ser, SelectParameters.CompressionType, str(value))
  783. elif SelectParameters.KeepAllColumns == key:
  784. _add_text_child(output_ser, SelectParameters.KeepAllColumns, str(value))
  785. elif SelectParameters.OutputRawData == key:
  786. _add_text_child(output_ser, SelectParameters.OutputRawData, str(value))
  787. elif SelectParameters.EnablePayloadCrc == key:
  788. _add_text_child(output_ser, SelectParameters.EnablePayloadCrc, str(value))
  789. elif SelectParameters.OutputHeader == key:
  790. _add_text_child(output_ser, SelectParameters.OutputHeader, str(value))
  791. elif SelectParameters.SkipPartialDataRecord == key:
  792. _add_text_child(options, SelectParameters.SkipPartialDataRecord, str(value))
  793. elif SelectParameters.MaxSkippedRecordsAllowed == key:
  794. _add_text_child(options, SelectParameters.MaxSkippedRecordsAllowed, str(value))
  795. elif SelectParameters.AllowQuotedRecordDelimiter == key:
  796. _add_text_child(csv, SelectParameters.AllowQuotedRecordDelimiter, str(value))
  797. else:
  798. raise SelectOperationClientError("The select_params contains unsupported key " + key, "")
  799. return _node_to_string(root)
  800. def to_select_json_object(sql, select_params):
  801. root = ElementTree.Element('SelectRequest')
  802. _add_text_child(root, 'Expression', base64.b64encode(str.encode(sql)))
  803. input_ser = ElementTree.SubElement(root, 'InputSerialization')
  804. output_ser = ElementTree.SubElement(root, 'OutputSerialization')
  805. json = ElementTree.SubElement(input_ser, 'JSON')
  806. out_json = ElementTree.SubElement(output_ser, 'JSON')
  807. options = ElementTree.SubElement(root, 'Options')
  808. is_doc = select_params[SelectParameters.Json_Type] == SelectJsonTypes.DOCUMENT
  809. _add_text_child(json, 'Type', select_params[SelectParameters.Json_Type])
  810. for key, value in select_params.items():
  811. if SelectParameters.SplitRange == key and is_doc == False:
  812. _add_text_child(json, 'Range', utils._make_split_range_string(value))
  813. elif SelectParameters.LineRange == key and is_doc == False:
  814. _add_text_child(json, 'Range', utils._make_line_range_string(value))
  815. elif SelectParameters.CompressionType == key:
  816. _add_text_child(input_ser, SelectParameters.CompressionType, value)
  817. elif SelectParameters.OutputRawData == key:
  818. _add_text_child(output_ser, SelectParameters.OutputRawData, str(value))
  819. elif SelectParameters.EnablePayloadCrc == key:
  820. _add_text_child(output_ser, SelectParameters.EnablePayloadCrc, str(value))
  821. elif SelectParameters.OutputRecordDelimiter == key:
  822. _add_text_child(out_json, SelectParameters.RecordDelimiter, base64.b64encode(str.encode(value)))
  823. elif SelectParameters.SkipPartialDataRecord == key:
  824. _add_text_child(options, SelectParameters.SkipPartialDataRecord, str(value))
  825. elif SelectParameters.MaxSkippedRecordsAllowed == key:
  826. _add_text_child(options, SelectParameters.MaxSkippedRecordsAllowed, str(value))
  827. elif SelectParameters.ParseJsonNumberAsString == key:
  828. _add_text_child(json, SelectParameters.ParseJsonNumberAsString, str(value))
  829. else:
  830. if key != SelectParameters.Json_Type:
  831. raise SelectOperationClientError("The select_params contains unsupported key " + key, "")
  832. return _node_to_string(root)
  833. def to_get_select_object_meta(meta_param):
  834. if meta_param is not None and SelectParameters.Json_Type in meta_param:
  835. if meta_param[SelectParameters.Json_Type] != SelectJsonTypes.LINES:
  836. raise SelectOperationClientError("Json_Type can only be 'LINES' for creating meta", "")
  837. else:
  838. return to_get_select_json_object_meta(meta_param)
  839. else:
  840. return to_get_select_csv_object_meta(meta_param)
  841. def to_get_select_csv_object_meta(csv_meta_param):
  842. root = ElementTree.Element('CsvMetaRequest')
  843. input_ser = ElementTree.SubElement(root, 'InputSerialization')
  844. csv = ElementTree.SubElement(input_ser, 'CSV')
  845. if (csv_meta_param is None):
  846. return _node_to_string(root)
  847. for key, value in csv_meta_param.items():
  848. if SelectParameters.RecordDelimiter == key:
  849. _add_text_child(csv, SelectParameters.RecordDelimiter, base64.b64encode(str.encode(value)))
  850. elif SelectParameters.FieldDelimiter == key:
  851. _add_text_child(csv, SelectParameters.FieldDelimiter, base64.b64encode(str.encode(value)))
  852. elif SelectParameters.QuoteCharacter == key:
  853. _add_text_child(csv, SelectParameters.QuoteCharacter, base64.b64encode(str.encode(value)))
  854. elif SelectParameters.CompressionType == key:
  855. _add_text_child(input_ser, SelectParameters.CompressionType, base64.b64encode(str.encode(value)))
  856. elif SelectParameters.OverwriteIfExists == key:
  857. _add_text_child(root, SelectParameters.OverwriteIfExists, str(value))
  858. else:
  859. raise SelectOperationClientError("The csv_meta_param contains unsupported key " + key, "")
  860. return _node_to_string(root)
  861. def to_get_select_json_object_meta(json_meta_param):
  862. root = ElementTree.Element('JsonMetaRequest')
  863. input_ser = ElementTree.SubElement(root, 'InputSerialization')
  864. json = ElementTree.SubElement(input_ser, 'JSON')
  865. _add_text_child(json, 'Type', json_meta_param[SelectParameters.Json_Type]) # Json_Type是必须的
  866. for key, value in json_meta_param.items():
  867. if SelectParameters.OverwriteIfExists == key:
  868. _add_text_child(root, SelectParameters.OverwriteIfExists, str(value))
  869. elif SelectParameters.CompressionType == key:
  870. _add_text_child(input_ser, SelectParameters.CompressionType, base64.b64encode(str.encode(value)))
  871. else:
  872. if SelectParameters.Json_Type != key:
  873. raise SelectOperationClientError("The json_meta_param contains unsupported key " + key, "")
  874. return _node_to_string(root)
  875. def to_put_tagging(object_tagging):
  876. root = ElementTree.Element("Tagging")
  877. tag_set = ElementTree.SubElement(root, "TagSet")
  878. for item in object_tagging.tag_set.tagging_rule:
  879. tag_xml = ElementTree.SubElement(tag_set, "Tag")
  880. _add_text_child(tag_xml, 'Key', item)
  881. _add_text_child(tag_xml, 'Value', object_tagging.tag_set.tagging_rule[item])
  882. return _node_to_string(root)
  883. def parse_get_tagging(result, body):
  884. root = ElementTree.fromstring(body)
  885. url_encoded = _is_url_encoding(root)
  886. tagset_node = root.find('TagSet')
  887. if tagset_node is None:
  888. return result
  889. tagging_rules = TaggingRule()
  890. for tag_node in tagset_node.findall('Tag'):
  891. key = _find_object(tag_node, 'Key', url_encoded)
  892. value = _find_object(tag_node, 'Value', url_encoded)
  893. tagging_rules.add(key, value)
  894. result.tag_set = tagging_rules
  895. return result
  896. def to_put_bucket_encryption(rule):
  897. root = ElementTree.Element("ServerSideEncryptionRule")
  898. apply_node = ElementTree.SubElement(root, "ApplyServerSideEncryptionByDefault")
  899. _add_text_child(apply_node, "SSEAlgorithm", rule.sse_algorithm)
  900. if rule.kms_master_keyid:
  901. _add_text_child(apply_node, "KMSMasterKeyID", rule.kms_master_keyid)
  902. if rule.kms_data_encryption:
  903. _add_text_child(apply_node, "KMSDataEncryption", rule.kms_data_encryption)
  904. return _node_to_string(root)
  905. def parse_get_bucket_encryption(result, body):
  906. root = ElementTree.fromstring(body)
  907. apply_node = root.find('ApplyServerSideEncryptionByDefault')
  908. result.sse_algorithm = _find_tag(apply_node, "SSEAlgorithm")
  909. kmsnode = apply_node.find('KMSMasterKeyID')
  910. if kmsnode is None or kmsnode.text is None:
  911. result.kms_master_keyid = None
  912. else:
  913. result.kms_master_keyid = to_string(kmsnode.text)
  914. kms_data_encryption_node = apply_node.find('KMSDataEncryption')
  915. if kms_data_encryption_node is None or kms_data_encryption_node.text is None:
  916. result.kms_data_encryption = None
  917. else:
  918. result.kms_data_encryption = to_string(kms_data_encryption_node.text)
  919. return result
  920. def parse_list_object_versions(result, body):
  921. root = ElementTree.fromstring(body)
  922. url_encoded = _is_url_encoding(root)
  923. result.is_truncated = _find_bool(root, 'IsTruncated')
  924. if result.is_truncated:
  925. result.next_key_marker = _find_object(root, 'NextKeyMarker', url_encoded)
  926. result.next_versionid_marker = _find_object(root, "NextVersionIdMarker", url_encoded)
  927. result.name = _find_tag(root, "Name")
  928. result.prefix = _find_object(root, "Prefix", url_encoded)
  929. result.key_marker = _find_object(root, "KeyMarker", url_encoded)
  930. result.versionid_marker = _find_object(root, "VersionIdMarker", url_encoded)
  931. result.max_keys = _find_int(root, "MaxKeys")
  932. result.delimiter = _find_object(root, "Delimiter", url_encoded)
  933. for delete_marker in root.findall("DeleteMarker"):
  934. deleteInfo = DeleteMarkerInfo()
  935. deleteInfo.key = _find_object(delete_marker, "Key", url_encoded)
  936. deleteInfo.versionid = _find_tag(delete_marker, "VersionId")
  937. deleteInfo.is_latest = _find_bool(delete_marker, "IsLatest")
  938. deleteInfo.last_modified = iso8601_to_unixtime(_find_tag(delete_marker, "LastModified"))
  939. deleteInfo.owner.id = _find_tag(delete_marker, "Owner/ID")
  940. deleteInfo.owner.display_name = _find_tag(delete_marker, "Owner/DisplayName")
  941. result.delete_marker.append(deleteInfo)
  942. for version in root.findall("Version"):
  943. versionInfo = ObjectVersionInfo()
  944. versionInfo.key = _find_object(version, "Key", url_encoded)
  945. versionInfo.versionid = _find_tag(version, "VersionId")
  946. versionInfo.is_latest = _find_bool(version, "IsLatest")
  947. versionInfo.last_modified = iso8601_to_unixtime(_find_tag(version, "LastModified"))
  948. versionInfo.owner.id = _find_tag(version, "Owner/ID")
  949. versionInfo.owner.display_name = _find_tag(version, "Owner/DisplayName")
  950. versionInfo.type = _find_tag(version, "Type")
  951. versionInfo.storage_class = _find_tag(version, "StorageClass")
  952. versionInfo.size = _find_int(version, "Size")
  953. versionInfo.etag = _find_tag(version, "ETag").strip('"')
  954. result.versions.append(versionInfo)
  955. for common_prefix in root.findall("CommonPrefixes"):
  956. result.common_prefix.append(_find_object(common_prefix, "Prefix", url_encoded))
  957. return result
  958. def to_put_bucket_versioning(bucket_version_config):
  959. root = ElementTree.Element('VersioningConfiguration')
  960. _add_text_child(root, 'Status', str(bucket_version_config.status))
  961. return _node_to_string(root)
  962. def parse_get_bucket_versioning(result, body):
  963. root = ElementTree.fromstring(body)
  964. status_node = root.find("Status")
  965. if status_node is None:
  966. result.status = None
  967. else:
  968. result.status = _find_tag(root, "Status")
  969. return result
  970. def to_put_bucket_request_payment(payer):
  971. root = ElementTree.Element('RequestPaymentConfiguration')
  972. _add_text_child(root, 'Payer', payer)
  973. return _node_to_string(root)
  974. def parse_get_bucket_request_payment(result, body):
  975. root = ElementTree.fromstring(body)
  976. result.payer = _find_tag(root, 'Payer')
  977. return result
  978. def to_put_qos_info(qos_info):
  979. root = ElementTree.Element("QoSConfiguration")
  980. if qos_info.total_upload_bw is not None:
  981. _add_text_child(root, "TotalUploadBandwidth", str(qos_info.total_upload_bw))
  982. if qos_info.intranet_upload_bw is not None:
  983. _add_text_child(root, "IntranetUploadBandwidth", str(qos_info.intranet_upload_bw))
  984. if qos_info.extranet_upload_bw is not None:
  985. _add_text_child(root, "ExtranetUploadBandwidth", str(qos_info.extranet_upload_bw))
  986. if qos_info.total_download_bw is not None:
  987. _add_text_child(root, "TotalDownloadBandwidth", str(qos_info.total_download_bw))
  988. if qos_info.intranet_download_bw is not None:
  989. _add_text_child(root, "IntranetDownloadBandwidth", str(qos_info.intranet_download_bw))
  990. if qos_info.extranet_download_bw is not None:
  991. _add_text_child(root, "ExtranetDownloadBandwidth", str(qos_info.extranet_download_bw))
  992. if qos_info.total_qps is not None:
  993. _add_text_child(root, "TotalQps", str(qos_info.total_qps))
  994. if qos_info.intranet_qps is not None:
  995. _add_text_child(root, "IntranetQps", str(qos_info.intranet_qps))
  996. if qos_info.extranet_qps is not None:
  997. _add_text_child(root, "ExtranetQps", str(qos_info.extranet_qps))
  998. return _node_to_string(root)
  999. def parse_get_qos_info(result, body):
  1000. """解析UserQosInfo 或者BucketQosInfo
  1001. :UserQosInfo包含成员region,其他成员同BucketQosInfo
  1002. """
  1003. root = ElementTree.fromstring(body)
  1004. if hasattr(result, 'region'):
  1005. result.region = _find_tag(root, 'Region')
  1006. result.total_upload_bw = _find_int(root, 'TotalUploadBandwidth')
  1007. result.intranet_upload_bw = _find_int(root, 'IntranetUploadBandwidth')
  1008. result.extranet_upload_bw = _find_int(root, 'ExtranetUploadBandwidth')
  1009. result.total_download_bw = _find_int(root, 'TotalDownloadBandwidth')
  1010. result.intranet_download_bw = _find_int(root, 'IntranetDownloadBandwidth')
  1011. result.extranet_download_bw = _find_int(root, 'ExtranetDownloadBandwidth')
  1012. result.total_qps = _find_int(root, 'TotalQps')
  1013. result.intranet_qps = _find_int(root, 'IntranetQps')
  1014. result.extranet_qps = _find_int(root, 'ExtranetQps')
  1015. return result
  1016. def parse_get_bucket_user_qos(result, body):
  1017. root = ElementTree.fromstring(body)
  1018. result.storage_capacity = _find_int(root, 'StorageCapacity')
  1019. return result
  1020. def to_put_bucket_user_qos(user_qos):
  1021. root = ElementTree.Element('BucketUserQos')
  1022. _add_text_child(root, 'StorageCapacity', str(user_qos.storage_capacity))
  1023. return _node_to_string(root)
  1024. def to_put_async_fetch_task(task_config):
  1025. root = ElementTree.Element('AsyncFetchTaskConfiguration')
  1026. _add_text_child(root, 'Url', task_config.url)
  1027. _add_text_child(root, 'Object', task_config.object_name)
  1028. if task_config.host is not None:
  1029. _add_text_child(root, 'Host', task_config.host)
  1030. if task_config.content_md5 is not None:
  1031. _add_text_child(root, 'ContentMD5', task_config.content_md5)
  1032. if task_config.callback is not None:
  1033. _add_text_child(root, 'Callback', task_config.callback)
  1034. if task_config.ignore_same_key is not None:
  1035. _add_text_child(root, 'IgnoreSameKey', str(task_config.ignore_same_key).lower())
  1036. return _node_to_string(root)
  1037. def parse_put_async_fetch_task_result(result, body):
  1038. root = ElementTree.fromstring(body)
  1039. result.task_id = _find_tag(root, 'TaskId')
  1040. return result
  1041. def _parse_async_fetch_task_configuration(task_info_node):
  1042. url = _find_tag(task_info_node, 'Url')
  1043. object_name = _find_tag(task_info_node, 'Object')
  1044. host = _find_tag(task_info_node, 'Host')
  1045. content_md5 = _find_tag(task_info_node, 'ContentMD5')
  1046. callback = _find_tag(task_info_node, 'Callback')
  1047. ignore_same_key = _find_bool(task_info_node, 'IgnoreSameKey')
  1048. return AsyncFetchTaskConfiguration(url, object_name, host, content_md5, callback, ignore_same_key)
  1049. def parse_get_async_fetch_task_result(result, body):
  1050. root = ElementTree.fromstring(body)
  1051. result.task_id = _find_tag(root, 'TaskId')
  1052. result.task_state = _find_tag(root, 'State')
  1053. result.error_msg = _find_tag(root, 'ErrorMsg')
  1054. result.task_config = _parse_async_fetch_task_configuration(root.find('TaskInfo'))
  1055. return result
  1056. def to_put_inventory_configuration(inventory_config):
  1057. root = ElementTree.Element("InventoryConfiguration")
  1058. _add_text_child(root, "Id", inventory_config.inventory_id)
  1059. if inventory_config.is_enabled is not None:
  1060. _add_text_child(root, "IsEnabled", str(inventory_config.is_enabled))
  1061. if inventory_config.included_object_versions is not None:
  1062. _add_text_child(root, "IncludedObjectVersions", inventory_config.included_object_versions)
  1063. if inventory_config.inventory_filter is not None and inventory_config.inventory_filter.prefix is not None:
  1064. filter_node = ElementTree.SubElement(root, 'Filter')
  1065. _add_text_child(filter_node, "Prefix", inventory_config.inventory_filter.prefix)
  1066. if inventory_config.inventory_schedule is not None and inventory_config.inventory_schedule.frequency is not None:
  1067. schedule_node = ElementTree.SubElement(root, 'Schedule')
  1068. _add_text_child(schedule_node, "Frequency", inventory_config.inventory_schedule.frequency)
  1069. if inventory_config.optional_fields is not None:
  1070. fields_node = ElementTree.SubElement(root, 'OptionalFields')
  1071. for field in inventory_config.optional_fields:
  1072. _add_text_child(fields_node, "Field", field)
  1073. if inventory_config.inventory_destination is not None and inventory_config.inventory_destination.bucket_destination is not None:
  1074. destin_node = ElementTree.SubElement(root, 'Destination')
  1075. bucket_destin_node = ElementTree.SubElement(destin_node, 'OSSBucketDestination')
  1076. bucket_destin = inventory_config.inventory_destination.bucket_destination
  1077. if bucket_destin.account_id is not None:
  1078. _add_text_child(bucket_destin_node, "AccountId", str(bucket_destin.account_id))
  1079. if bucket_destin.role_arn is not None:
  1080. _add_text_child(bucket_destin_node, "RoleArn", bucket_destin.role_arn)
  1081. if bucket_destin.bucket is not None:
  1082. _add_text_child(bucket_destin_node, "Bucket", "acs:oss:::" + bucket_destin.bucket)
  1083. if bucket_destin.inventory_format is not None:
  1084. _add_text_child(bucket_destin_node, "Format", bucket_destin.inventory_format)
  1085. if bucket_destin.prefix is not None:
  1086. _add_text_child(bucket_destin_node, "Prefix", bucket_destin.prefix)
  1087. if bucket_destin.sse_kms_encryption is not None:
  1088. encryption_node = ElementTree.SubElement(bucket_destin_node, 'Encryption')
  1089. sse_kms_node = ElementTree.SubElement(encryption_node, 'SSE-KMS')
  1090. _add_text_child(sse_kms_node, "KeyId", bucket_destin.sse_kms_encryption.key_id)
  1091. elif bucket_destin.sse_oss_encryption is not None:
  1092. encryption_node = ElementTree.SubElement(bucket_destin_node, 'Encryption')
  1093. _add_node_child(encryption_node, 'SSE-OSS')
  1094. return _node_to_string(root)
  1095. def get_Inventory_configuration_from_element(elem):
  1096. root = elem
  1097. result = InventoryConfiguration()
  1098. result.inventory_id = _find_tag(root, 'Id')
  1099. result.is_enabled = _find_bool(root, 'IsEnabled')
  1100. result.included_object_versions = _find_tag(root, 'IncludedObjectVersions')
  1101. if root.find("Filter/Prefix") is not None:
  1102. result.inventory_filter = InventoryFilter(_find_tag(root, 'Filter/Prefix'))
  1103. if root.find("Schedule/Frequency") is not None:
  1104. result.inventory_schedule = InventorySchedule(_find_tag(root, 'Schedule/Frequency'))
  1105. result.optional_fields = _find_all_tags(root, "OptionalFields/Field")
  1106. if root.find("Destination/OSSBucketDestination") is not None:
  1107. bucket_distin_node = root.find("Destination/OSSBucketDestination")
  1108. account_id = None
  1109. role_arn = None
  1110. bucket = None
  1111. inventory_format = None
  1112. prefix = None
  1113. sse_kms_encryption = None
  1114. sse_oss_encryption = None
  1115. if bucket_distin_node.find('AccountId') is not None:
  1116. account_id = _find_tag(bucket_distin_node, 'AccountId')
  1117. if bucket_distin_node.find('RoleArn') is not None:
  1118. role_arn = _find_tag(bucket_distin_node, 'RoleArn')
  1119. if bucket_distin_node.find('Bucket') is not None:
  1120. origin_bucket = _find_tag(bucket_distin_node, 'Bucket')
  1121. if origin_bucket.startswith('acs:oss:::'):
  1122. bucket = origin_bucket.replace('acs:oss:::', '')
  1123. if bucket_distin_node.find('Format') is not None:
  1124. inventory_format = _find_tag(bucket_distin_node, 'Format')
  1125. if bucket_distin_node.find('Prefix') is not None:
  1126. prefix = _find_tag(bucket_distin_node, 'Prefix')
  1127. sse_kms_node = bucket_distin_node.find("Encryption/SSE-KMS")
  1128. if sse_kms_node is not None:
  1129. sse_kms_encryption = InventoryServerSideEncryptionKMS(_find_tag(sse_kms_node, 'KeyId'))
  1130. elif bucket_distin_node.find("Encryption/SSE-OSS") is not None:
  1131. sse_oss_encryption = InventoryServerSideEncryptionOSS()
  1132. bucket_destination = InventoryBucketDestination(account_id=account_id, role_arn=role_arn,
  1133. bucket=bucket, inventory_format=inventory_format, prefix=prefix,
  1134. sse_kms_encryption=sse_kms_encryption, sse_oss_encryption=sse_oss_encryption)
  1135. result.inventory_destination = InventoryDestination(bucket_destination)
  1136. return result
  1137. def parse_get_bucket_inventory_configuration(result, body):
  1138. root = ElementTree.fromstring(body)
  1139. inventory_config = get_Inventory_configuration_from_element(root)
  1140. result.inventory_id = inventory_config.inventory_id
  1141. result.is_enabled = inventory_config.is_enabled
  1142. result.included_object_versions = inventory_config.included_object_versions
  1143. result.inventory_filter = inventory_config.inventory_filter
  1144. result.inventory_schedule = inventory_config.inventory_schedule
  1145. result.optional_fields = inventory_config.optional_fields
  1146. result.inventory_destination = inventory_config.inventory_destination
  1147. return result
  1148. def parse_list_bucket_inventory_configurations(result, body):
  1149. root = ElementTree.fromstring(body)
  1150. for inventory_config_node in root.findall("InventoryConfiguration"):
  1151. inventory_config = get_Inventory_configuration_from_element(inventory_config_node)
  1152. result.inventory_configurations.append(inventory_config)
  1153. if root.find("ContinuationToken") is not None:
  1154. result.continuaiton_token = _find_tag(root, "ContinuationToken")
  1155. if root.find("IsTruncated") is not None:
  1156. result.is_truncated = _find_bool(root, "IsTruncated")
  1157. if root.find("NextContinuationToken") is not None:
  1158. result.next_continuation_token = _find_tag(root, "NextContinuationToken")
  1159. return result
  1160. def to_put_restore_config(restore_config):
  1161. root = ElementTree.Element('RestoreRequest')
  1162. _add_text_child(root, 'Days', str(restore_config.days))
  1163. if restore_config.job_parameters is not None:
  1164. job_parameters = restore_config.job_parameters
  1165. job_parameters_node = ElementTree.SubElement(root, "JobParameters")
  1166. if job_parameters.tier is not None:
  1167. _add_text_child(job_parameters_node, 'Tier', job_parameters.tier)
  1168. return _node_to_string(root)
  1169. def parse_get_bucket_worm_result(result, body):
  1170. root = ElementTree.fromstring(body)
  1171. result.worm_id = _find_tag(root, "WormId")
  1172. result.state = _find_tag(root, "State")
  1173. result.retention_period_days = _find_int(root, "RetentionPeriodInDays")
  1174. result.creation_date = _find_tag(root, "CreationDate")
  1175. def to_put_extend_bucket_worm(retention_period_days):
  1176. root = ElementTree.Element('ExtendWormConfiguration')
  1177. _add_text_child(root, 'RetentionPeriodInDays', str(retention_period_days))
  1178. return _node_to_string(root)
  1179. def to_put_init_bucket_worm(retention_period_days):
  1180. root = ElementTree.Element('InitiateWormConfiguration')
  1181. _add_text_child(root, 'RetentionPeriodInDays', str(retention_period_days))
  1182. return _node_to_string(root)