BS ISO IEC 17963-2013 Web Services for Management (WS-Management) Specification《Web服务管理(WS管理)规范 》.pdf

1、raising standards worldwide NO COPYING WITHOUT BSI PERMISSION EXCEPT AS PERMITTED BY COPYRIGHT LAW BSI Standards Publication BS ISO/IEC 17963:2013 Web Services for Management (WS-Management) Specification BS ISO/IEC 17963:2013 BRITISH STANDARD National foreword This British Standard is the UK implem

2、entation of ISO/IEC 17963:2013. The UK participation in its preparation was entrusted to Technical Committee ICT/-/1, Information systems co-ordination. A list of organizations represented on this committee can be obtained on request to its secretary. This publication does not purport to include all

3、 the necessary provisions of a contract. Users are responsible for its correct application. The British Standards Institution 2013. Published by BSI Standards Limited 2013 ISBN 978 0 580 77532 1 ICS 35.020 Compliance with a British Standard cannot confer immunity from legal obligations. This British

4、 Standard was published under the authority of the Standards Policy and Strategy Committee on 28 February 2013. Amendments issued since publication Date T e x t a f f e c t e dBS ISO/IEC 17963:2013Reference number ISO/IEC 17963:2013(E) ISO/IEC 2013INTERNATIONAL STANDARD ISO/IEC 17963 First edition 2

5、013-02-01 Web Services for Management (WS-Management) Specification Spcification des services Web pour le management (WS-Management) BS ISO/IEC 17963:2013 ISO/IEC 17963:2012(E) COPYRIGHT PROTECTED DOCUMENT ISO/IEC 2013 All rights reserved. Unless otherwise specified, no part of this publication may

6、be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting on the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address below or ISOs member body in the country of the r

7、equester. ISO copyright office Case postale 56 CH-1211 Geneva 20 Tel. + 41 22 749 01 11 Fax + 41 22 749 09 47 E-mail copyrightiso.org Web www.iso.org Published in Switzerland ii ISO/IEC 2013 All rights reservedBS ISO/IEC 17963:2013 ISO/IEC 17963:2013(E) ISO/IEC 2013 All rights reserved iiiForeword I

8、SO (the International Organization for Standardization) and IEC (the International Electrotechnical Commission) form the specialized system for worldwide standardization. National bodies that are members of ISO or IEC participate in the development of International Standards through technical commit

9、tees established by the respective organization to deal with particular fields of technical activity. ISO and IEC technical committees collaborate in fields of mutual interest. Other international organizations, governmental and non-governmental, in liaison with ISO and IEC, also take part in the wo

10、rk. In the field of information technology, ISO and IEC have established a joint technical committee, ISO/IEC JTC 1. International Standards are drafted in accordance with the rules given in the ISO/IEC Directives, Part 2. The main task of the joint technical committee is to prepare International St

11、andards. Draft International Standards adopted by the joint technical committee are circulated to national bodies for voting. Publication as an International Standard requires approval by at least 75 % of the national bodies casting a vote. Attention is drawn to the possibility that some of the elem

12、ents of this document may be the subject of patent rights. ISO and IEC shall not be held responsible for identifying any or all such patent rights. ISO/IEC 17963 was prepared by Joint Technical Committee ISO/IEC JTC 1, Information technology, Subcommittee SC 38, Distributed application platforms and

13、 services (DAPS). BS ISO/IEC 17963:2013BS ISO/IEC 17963:20131 Document Number: DSP0226 2 Date: 2012-08-28 3 Version: 1.1.1 4 Web Services for Management (WS- 5 Management) Specification 6 Document Type: Specification 7 Document Status: DMTF Standard 8 Document Language: en-US 9 ISO/IEC 2013 All righ

14、ts reserved ISO/IEC 17963:2013(E) 1 BS ISO/IEC 17963:2013BS ISO/IEC 17963:2013 Web Services for Management (WS-Management) Specification DSP0226 2 DMTF Standard Version 1.1.1 Copyright Notice 10 Copyright 20062012 Distributed Management Task Force, Inc. (DMTF). All rights reserved. 11 DMTF is a not-

15、for-profit association of industry members dedicated to promoting enterprise and systems 12 management and interoperability. Members and non-members may reproduce DMTF specifications and 13 documents, provided that correct attribution is given. As DMTF specifications may be revised from time to 14 t

16、ime, the particular version and release date should always be noted. 15 Implementation of certain elements of this standard or proposed standard may be subject to third party 16 patent rights, including provisional patent rights (herein “patent rights“). DMTF makes no representations 17 to users of

17、the standard as to the existence of such rights, and is not responsible to recognize, disclose, 18 or identify any or all such third party patent right, owners or claimants, nor for any incomplete or 19 inaccurate identification or disclosure of such rights, owners or claimants. DMTF shall have no l

18、iability to 20 any party, in any manner or circumstance, under any legal theory whatsoever, for failure to recognize, 21 disclose, or identify any such third party patent rights, or for such partys reliance on the standard or 22 incorporation thereof in its product, protocols or testing procedures.

19、DMTF shall have no liability to any 23 party implementing such standard, whether such implementation is foreseeable or not, nor to any patent 24 owner or claimant, and shall have no liability or responsibility for costs or losses incurred if a standard is 25 withdrawn or modified after publication,

20、and shall be indemnified and held harmless by any party 26 implementing the standard from any and all claims of infringement by a patent owner for such 27 implementations. 28 For information about patents held by third-parties which have notified the DMTF that, in their opinion, 29 such patent may r

21、elate to or impact implementations of DMTF standards, visit 30 http:/www.dmtf.org/about/policies/disclosures.php. 31 32 ISO/IEC 2013 All rights reserved ISO/IEC 17963:2013(E) 2 BS ISO/IEC 17963:2013BS ISO/IEC 17963:2013 DSP0226 Web Services for Management (WS-Management) Specification Version 1.1.1

22、DMTF Standard 3 CONTENTS 33 Foreword 7 34 1 Scope . 10 35 2 Normative References . 10 36 3 Terms and Definitions 12 37 4 Symbols and Abbreviated Terms . 15 38 5 Addressing . 16 39 5.1 Management Addressing 16 40 5.2 Versions of Addressing 25 41 5.3 Requirements for Compatibility . 25 42 5.4 Use of A

23、ddressing in WS-Management 27 43 6 WS-Management Control Headers 44 44 6.1 wsman:OperationTimeout . 44 45 6.2 wsman:MaxEnvelopeSize . 45 46 6.3 wsman:Locale . 46 47 6.4 wsman:OptionSet 47 48 6.5 wsman:RequestEPR . 50 49 7 Resource Access . 51 50 7.1 General 51 51 7.2 Addressing Uniformity . 53 52 7.

24、3 Get . 54 53 7.4 Put . 55 54 7.5 Delete 59 55 7.6 Create 61 56 7.7 Fragment-Level Access . 64 57 7.8 Fragment-Level Get 66 58 7.9 Fragment-Level Put . 67 59 7.10 Fragment-Level Delete 70 60 7.11 Fragment-Level Create . 71 61 8 Enumeration of Datasets . 73 62 8.1 General 73 63 8.2 Enumerate . 75 64

25、8.3 Filter Interpretation 82 65 8.4 Pull . 84 66 8.5 Release . 88 67 8.6 Ad-Hoc Queries and Fragment-Level Enumerations 90 68 8.7 Enumeration of EPRs 90 69 8.8 Renew . 92 70 8.9 GetStatus. 94 71 8.10 EnumerationEnd 94 72 9 Custom Actions (Methods) . 95 73 10 Notifications (Eventing) 96 74 10.1 Gener

26、al 96 75 10.2 Subscribe. 97 76 10.3 GetStatus. 117 77 10.4 Unsubscribe. 118 78 10.5 Renew . 119 79 10.6 SubscriptionEnd 120 80 10.7 Acknowledgement of Delivery . 122 81 10.8 Refusal of Delivery 123 82 10.9 Dropped Events . 124 83 10.10 Access Control 125 84 ISO/IEC 2013 All rights reserved ISO/IEC 1

27、7963:2013(E) 3 BS ISO/IEC 17963:2013BS ISO/IEC 17963:2013 Web Services for Management (WS-Management) Specification DSP0226 4 DMTF Standard Version 1.1.1 10.11 Implementation Considerations . 126 85 10.12 Advertisement of Notifications . 126 86 11 Metadata and Discovery 126 87 12 Security 129 88 12.

28、1 General 129 89 12.2 Security Profiles 130 90 12.3 Security Considerations for Event Subscriptions 130 91 12.4 Including Credentials with a Subscription . 131 92 12.5 Correlating Events with a Subscription . 132 93 12.6 Transport-Level Authentication Failure . 132 94 12.7 Security Implications of T

29、hird-Party Subscriptions 132 95 13 Transports and Message Encoding . 133 96 13.1 SOAP . 133 97 13.2 Lack of Response 134 98 13.3 Replay of Messages 134 99 13.4 Encoding Limits . 134 100 13.5 Binary Attachments . 135 101 13.6 Case-Sensitivity . 135 102 14 Faults . 136 103 14.1 Introduction 136 104 14

30、.2 Fault Encoding 136 105 14.3 NotUnderstood Faults . 137 106 14.4 Degenerate Faults . 138 107 14.5 Fault Extensibility 138 108 14.6 Master Faults . 139 109 ANNEX A (informative) Notational Conventions . 160 110 A.1 XML Namespaces . 160 111 ANNEX B (normative) Conformance 162 112 ANNEX C (normative)

31、 HTTP(S) Transport and Security Profile 163 113 C.1 General 163 114 C.2 HTTP(S) Binding . 163 115 C.3 HTTP(S) Security Profiles . 165 116 C.4 IPSec and HTTP . 170 117 ANNEX D (informative) XPath Support 171 118 D.1 General 171 119 D.2 Level 1 . 172 120 D.3 Level 2 . 174 121 ANNEX E (normative) Selec

32、tor Filter Dialect . 177 122 ANNEX F (informative) Identify XML Schema 179 123 ANNEX G (informative) Resource Access Operations XML Schema and WSDL . 182 124 ANNEX H (informative) Enumeration Operations XML Schema and WSDL . 187 125 ANNEX I (informative) Notification OperationsXML Schema and WSDL 19

33、6 126 ANNEX J (informative) Addressing XML Schema 204 127 ANNEX K (informative) WS-Management XML Schema . 207 128 ANNEX L (informative) Change Log . 217 129 130 ISO/IEC 2013 All rights reserved ISO/IEC 17963:2013(E) 4 BS ISO/IEC 17963:2013BS ISO/IEC 17963:2013 DSP0226 Web Services for Management (W

34、S-Management) Specification Version 1.1.1 DMTF Standard 5 Figures 131 Figure 1 Message Information Header Blocks . 20 132 133 Tables 134 Table 1 Relationship Type 21 135 Table 2 Interoperability Requirements . 25 136 Table 3 WSA Versions in Exchanges . 26 137 Table 4 wsa:Action URI Descriptions . 42

35、 138 Table 5 wsman:AccessDenied . 139 139 Table 6 wsa:ActionNotSupported . 140 140 Table 7 wsman:AlreadyExists 140 141 Table 8 wsmen:CannotProcessFilter . 141 142 Table 9 wsman:CannotProcessFilter . 141 143 Table 10 wsman:Concurrency 142 144 Table 11 wsme:DeliveryModeRequestedUnavailable 142 145 Tab

36、le 12 wsman:DeliveryRefused 143 146 Table 13 wsa:DestinationUnreachable . 143 147 Table 14 wsman:EncodingLimit 144 148 Table 15 wsa:EndpointUnavailable 145 149 Table 16 wsman:EventDeliverToUnusable 145 150 Table 17 wsme:EventSourceUnableToProcess . 146 151 Table 18 wsmen:FilterDialectRequestedUnavai

37、lable . 146 152 Table 19 wsme:FilteringNotSupported . 146 153 Table 20 wsmen:FilteringNotSupported . 147 154 Table 21 wsme:FilteringRequestedUnavailable . 147 155 Table 22 wsman:FragmentDialectNotSupported . 148 156 Table 23 wsman:InternalError 148 157 Table 24 wsman:InvalidBookmark . 149 158 Table

38、25 wsmen:InvalidEnumerationContext . 149 159 Table 26 wsme:InvalidExpirationTime 150 160 Table 27 wsmen:InvalidExpirationTime 150 161 Table 28 wsme:InvalidMessage . 151 162 Table 29 wsa:InvalidMessageInformationHeader 151 163 Table 30 wsman:InvalidOptions . 152 164 Table 31 wsman:InvalidParameter .

39、152 165 Table 32 wsmt:InvalidRepresentation 153 166 Table 33 wsman:InvalidSelectors . 153 167 Table 34 wsa:MessageInformationHeaderRequired 154 168 Table 35 wsman:NoAck 154 169 Table 36 wsman:QuotaLimit . 154 170 Table 37 wsman:SchemaValidationError . 155 171 ISO/IEC 2013 All rights reserved ISO/IEC

40、 17963:2013(E) 5 BS ISO/IEC 17963:2013BS ISO/IEC 17963:2013 Web Services for Management (WS-Management) Specification DSP0226 6 DMTF Standard Version 1.1.1 Table 38 wsmen:TimedOut 155 172 Table 39 wsman:TimedOut 155 173 Table 40 wsme:UnableToRenew . 156 174 Table 41 wsme:UnsupportedExpirationType .

41、156 175 Table 42 wsmen:UnsupportedExpirationType . 156 176 Table 43 wsman:UnsupportedFeature . 157 177 Table 44 wsme:UnsupportedExpirationType . 158 178 Table 45 wsmen:UnableToRenew . 158 179 Table 46 wsa:InvalidMessage 158 180 Table 47 wsme:CannotProcessFilter . 159 181 Table A-1 Prefixes and XML N

42、amespaces Used in This Specification 161 182 Table C-1 Basic Authentication Sequence . 165 183 Table C-2 Digest Authentication Sequence . 166 184 Table C-3 Basic Authentication over HTTPS Sequence 166 185 Table C-4 Digest Authentication over HTTPS Sequence 167 186 Table C-5 HTTPS with Client Certifi

43、cate Sequence . 167 187 Table C-6 Basic Authentication over HTTPS with Client Certificate Sequence . 168 188 Table C-7 SPNEGO Authentication over HTTPS Sequence . 169 189 Table C-8 SPNEGO Authentication over HTTPS with Client Certificate Sequence 169 190 Table D-1 XPath Level 1 Terminals . 173 191 T

44、able D-2 XPath Level 2 Terminals . 175 192 193 ISO/IEC 2013 All rights reserved ISO/IEC 17963:2013(E) 6 BS ISO/IEC 17963:2013BS ISO/IEC 17963:2013 DSP0226 Web Services for Management (WS-Management) Specification Version 1.1.1 DMTF Standard 7 Foreword 194 The Web Services for Management (WS-Manageme

45、nt) Specification (DSP0226) was prepared by the 195 WS-Management sub-group of the WBEM Infrastructure & Protocols Working Group. 196 This International Standard makes use of functionality similar to the following W3C 197 Recommendations: 198 Web Services Eventing (WS-Eventing) 199 Web Services Tran

46、sfer (WS-Transfer) 200 Web Services Enumeration (WS-Enumeration) 201 These W3C Recommendations were not available at the time WS-Management was defined, and 202 similar functionality was incorporated directly into provisions of the WS-Management specification. 203 Future revisions of WS-Management m

47、ight incorporate these functions by External Reference to 204 these W3C Recommendations 205 DMTF is a not-for-profit association of industry members dedicated to promoting enterprise and 206 systems management and interoperability. 207 Acknowledgements 208 The authors wish to acknowledge the followi

48、ng people. 209 Chairpersons: 210 Josh Cohen Microsoft 211 Larry Lamers (Vice-Chairman) VMware 212 Editors: 213 Nathan Burkhart Microsoft 214 Doug Davis IBM 215 Raymond McCollum Microsoft 216 Bryan Murray HP 217 Brian Reistad Microsoft 218 Authors: 219 Akhil Arora Sun Microsystems 220 Vince Brunssen

49、IBM 221 Mark Carlson Sun Microsystems 222 Jim Davis WBEM Solutions 223 Tony Dicenzo Oracle 224 Mike Dutch Symantec 225 Zulah Eckert BEA Systems 226 George Ericson EMC 227 Wassim Fayed Microsoft 228 Chris Ferris IBM 229 Bob Freund Hitachi Ltd. 230 Eugene Golovinsky BMC Software 231 Yasuhiro Hagiwara NEC 232 ISO/IEC 2013 All rights reserved IS