1、raising standards worldwideNO COPYING WITHOUT BSI PERMISSION EXCEPT AS PERMITTED BY COPYRIGHT LAWBSI Standards PublicationBS ISO/IEC 17963:2013Web Services for Management (WS-Management) Specification BS ISO/IEC 17963:2013 BRITISH STANDARDNational forewordThis British Standard is the UK implementati
2、on of ISO/IEC 17963:2013.The UK participation in its preparation was entrusted to TechnicalCommittee 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 the neces
3、sary provisions of a contract. Users are responsible for its correct application. The British Standards Institution 2013. Published by BSI Standards Limited 2013ISBN 978 0 580 77532 1 ICS 35.020 Compliance with a British Standard cannot confer immunity from legal obligations.This British Standard wa
4、s published under the authority of the Standards Policy and Strategy Committee on 28 February 2013.Amendments issued since publicationDate T e x t a f f e c t e dBS ISO/IEC 17963:2013Reference numberISO/IEC 17963:2013(E)ISO/IEC 2013INTERNATIONAL STANDARD ISO/IEC17963First edition2013-02-01Web Servic
5、es for Management (WS-Management) Specification Spcification des services Web pour le management (WS-Management) BS ISO/IEC 17963:2013ISO/IEC 17963:2012(E) COPYRIGHT PROTECTED DOCUMENT ISO/IEC 2013 All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or util
6、ized 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 requester. ISO copyrig
7、ht 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:2013ISO/IEC 17963:2013(E) ISO/IEC 2013 All rights reserved iiiForeword ISO (the International
8、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 committees established by th
9、e 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 work. In the field of in
10、formation 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 Standards. Draft Interna
11、tional 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 elements of this document
12、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 services (DAPS). BS I
13、SO/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 rights reservedISO/IEC 1796
14、3:2013(E) 1BS ISO/IEC 17963:2013BS ISO/IEC 17963:2013Web 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-for-profit association of
15、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 time, the particular versio
16、n 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 the standard as to the exi
17、stence 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 liability to 20 any party,
18、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. DMTF shall have no liabili
19、ty 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, and shall be indemnified a
20、nd 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 relate to or impact impleme
21、ntations of DMTF standards, visit 30 http:/www.dmtf.org/about/policies/disclosures.php. 31 32 ISO/IEC 2013 All rights reservedISO/IEC 17963:2013(E)2BS ISO/IEC 17963:2013BS ISO/IEC 17963:2013DSP0226 Web Services for Management (WS-Management) Specification Version 1.1.1 DMTF Standard 3 CONTENTS 33 Fo
22、reword 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 Addressing in WS-Management 27
23、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.3 Get . 54 53 7.4 Put . 55 54
24、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 8.3 Filter Interpretation 82 6
25、5 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 General 96 75 10.2 Subscribe. 97 76
26、 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 reservedISO/IEC 17963:2013(E) 3BS ISO/IEC 17963:
27、2013BS ISO/IEC 17963:2013Web 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.1 General 129 89 12.2 Security Pr
28、ofiles 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 Third-Party Subscriptions 132 95 1
29、3 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.2 Fault Encoding 136 105 14.3 No
30、tUnderstood 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) HTTP(S) Transport and Security P
31、rofile 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) Selector Filter Dialect . 177 122 ANNE
32、X 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 196 126 ANNEX J (informative) Addre
33、ssing 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 reservedISO/IEC 17963:2013(E)4BS ISO/IEC 17963:2013BS ISO/IEC 17963:2013DSP0226 Web Services for Management (WS-Management) Specification Version 1
34、.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 138 Table 5 wsman:AccessDenied . 139
35、 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 Table 12 wsman:DeliveryRefused 143 146 T
36、able 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:FilterDialectRequestedUnavailable . 146 152 Table 19 wsme:Filteri
37、ngNotSupported . 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 25 wsmen:InvalidEnumerationContext .
38、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 . 152 165 Table 32 wsmt:InvalidRepresen
39、tation 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 reservedISO/IEC 17963:2013(E) 5BS ISO/IEC 17963:2013B
40、S ISO/IEC 17963:2013Web 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 . 156 175 Table 42 wsmen:UnsupportedExpira
41、tionType . 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 Namespaces Used in This Specification 161
42、 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 Certificate Sequence . 167 187 Table C-6 Basic
43、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 Table D-2 XPath Level 2 Terminals . 175 1
44、92 193 ISO/IEC 2013 All rights reservedISO/IEC 17963:2013(E)6BS ISO/IEC 17963:2013BS ISO/IEC 17963:2013DSP0226 Web Services for Management (WS-Management) Specification Version 1.1.1 DMTF Standard 7 Foreword 194 The Web Services for Management (WS-Management) Specification (DSP0226) was prepared by
45、the 195 WS-Management sub-group of the WBEM Infrastructure reference parameters should be used instead. 635 wsa:EndpointReference/wsa:ReferenceProperties/any 636 Each child element of ReferenceProperties represents an individual reference property. 637 wsa:EndpointReference/wsa:ReferenceParameters/
46、638 This optional element contains any number of individual parameters that are associated with the 639 endpoint to facilitate a particular interaction. Reference parameters are XML elements that are 640 required to properly interact with the endpoint. Reference parameters are also provided by the 6
47、41 issuer of the endpoint reference and are otherwise assumed to be opaque to consuming 642 applications. 643 See 5.4 for some WS-Management-specific reference parameters. 644 wsa:EndpointReference/wsa:ReferenceParameters/any 645 Each child element of ReferenceParameters represents an individual ref
48、erence parameter. 646 wsa:EndpointReference/wsa:PortType 647 This optional element (of type xs:QName) specifies the value of the primary portType of the 648 endpoint being conveyed. 649 NOTE: The use of wsa:PortType is deprecated. 650 wsa:EndpointReference/wsa:ServiceName 651 This optional element (
49、of type xs:QName) specifies the definition that contains a 652 WSDL description of the endpoint being referenced. The service name provides a link to a full 653 description of the service endpoint. An optional non-qualified name identifies the specific port in 654 the service that corresponds to the endpoint. 655 NOTE: The use of wsa:ServiceName is deprecated. 656 wsa:EndpointReference/wsa:ServiceName/PortName 657 This option
