ISO/IEC 17963:2013

Web Services for Management (WS-Management) Specification

ISO/IEC 17963:2013 describes a Web services protocol based on SOAP for use in management‑specific domains. These domains include the management of entities such as PCs, servers, devices, Web services and other applications manageable entities. Services can expose only a WS-Management interface or compose the WS-Management service interface with some of the many other Web service specifications. A crucial application for these services is in the area of systems management. To promote interoperability between management applications and managed resources, ISO/IEC PAS 17963:2012 identifies a core set of Web service specifications and usage requirements that expose a common set of operations central to all systems management. This includes the ability to do the following: a) get, put (update), create, and delete individual resource instances, such as settings and dynamic values; b) enumerate the contents of containers and collections, such as large tables and logs; c) subscribe to events emitted by managed resources; d) execute specific management methods with strongly typed input and output parameters. In each of these areas of scope, ISO/IEC 17963:2013 defines minimal implementation requirements for conformant Web service implementations. An implementation is free to extend beyond this set of operations, and to choose not to support one or more of the preceding areas of functionality if that functionality is not appropriate to the target device or system. ISO/IEC 17963:2013 intends to meet the following requirements: a) constrain Web services protocols and formats so that Web services can be implemented with a small footprint in both hardware and software management services; b) define minimum requirements for compliance without constraining richer implementations; c) ensure backward compatibility and interoperability with WS-Management version 1.0; d) ensure composability with other Web services specifications.

Spécification des services Web pour le management (WS-Management)

General Information

• Status: Published
• Publication Date: 27-Jan-2013
• ICS: 35.020 - Information technology (IT) in general
• Technical Committee: ISO/IEC JTC 1/SC 38 - Cloud computing and distributed platforms
• Drafting Committee: ISO/IEC JTC 1/SC 38 - Cloud computing and distributed platforms
• Current Stage: 9093 - International Standard confirmed
• Completion Date: 30-Apr-2021

Standards Content (Sample)

INTERNATIONAL ISO/IEC
STANDARD 17963
First edition
2013-02-01


Web Services for Management
(WS-Management) Specification
Spécification des services Web pour le management
(WS-Management)




Reference number
ISO/IEC 17963:2013(E)
©
ISO/IEC 2013

---------------------- Page: 1 ----------------------
ISO/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 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 ISO’s member body in the country of the requester.
ISO copyright office
Case postale 56  CH-1211 Geneva 20
Tel. + 41 22 749 01 11
Fax + 41 22 749 09 47
E-mail [e-mail]
Web www.iso.org
Published in Switzerland

ii © ISO/IEC 2013 – All rights reserved

---------------------- Page: 2 ----------------------
ISO/IEC 17963:2013(E)
Foreword
ISO (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 committees
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 work. 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 Standards. 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 elements 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 services (DAPS).


© ISO/IEC 2013 – All rights reserved iii

---------------------- Page: 3 ----------------------
ISO/IEC 17963:2013(E)
1
2 Document Number: DSP0226
3 Date: 2012-08-28
4 Version: 1.1.1
5 Web Services for Management (WS-
6 Management) Specification
7 Document Type: Specification
8 Document Status: DMTF Standard
9 Document Language: en-US
© ISO/IEC 2013 – All rights reserved
1

---------------------- Page: 4 ----------------------
ISO/IEC 17963:2013(E)
Web Services for Management (WS-Management) Specification DSP0226
10 Copyright Notice
11 Copyright © 2006–2012 Distributed Management Task Force, Inc. (DMTF). All rights reserved.
12 DMTF is a not-for-profit association of industry members dedicated to promoting enterprise and systems
13 management and interoperability. Members and non-members may reproduce DMTF specifications and
14 documents, provided that correct attribution is given. As DMTF specifications may be revised from time to
15 time, the particular version and release date should always be noted.
16 Implementation of certain elements of this standard or proposed standard may be subject to third party
17 patent rights, including provisional patent rights (herein "patent rights"). DMTF makes no representations
18 to users of the standard as to the existence of such rights, and is not responsible to recognize, disclose,
19 or identify any or all such third party patent right, owners or claimants, nor for any incomplete or
20 inaccurate identification or disclosure of such rights, owners or claimants. DMTF shall have no liability to
21 any party, in any manner or circumstance, under any legal theory whatsoever, for failure to recognize,
22 disclose, or identify any such third party patent rights, or for such party’s reliance on the standard or
23 incorporation thereof in its product, protocols or testing procedures. DMTF shall have no liability to any
24 party implementing such standard, whether such implementation is foreseeable or not, nor to any patent
25 owner or claimant, and shall have no liability or responsibility for costs or losses incurred if a standard is
26 withdrawn or modified after publication, and shall be indemnified and held harmless by any party
27 implementing the standard from any and all claims of infringement by a patent owner for such
28 implementations.
29 For information about patents held by third-parties which have notified the DMTF that, in their opinion,
30 such patent may relate to or impact implementations of DMTF standards, visit
31 http://www.dmtf.org/about/policies/disclosures.php.
32
2 DMTF Standard Version 1.1.1
2
© ISO/IEC 2013 – All rights reserved

---------------------- Page: 5 ----------------------
ISO/IEC 17963:2013(E)
DSP0226 Web Services for Management (WS-Management) Specification
33 CONTENTS
34 Foreword . 7
35 1 Scope . 10
36 2 Normative References . 10
37 3 Terms and Definitions . 12
38 4 Symbols and Abbreviated Terms . 15
39 5 Addressing . 16
40 5.1 Management Addressing . 16
41 5.2 Versions of Addressing . 25
42 5.3 Requirements for Compatibility . 25
43 5.4 Use of Addressing in WS-Management . 27
44 6 WS-Management Control Headers. 44
45 6.1 wsman:OperationTimeout . 44
46 6.2 wsman:MaxEnvelopeSize . 45
47 6.3 wsman:Locale . 46
48 6.4 wsman:OptionSet . 47
49 6.5 wsman:RequestEPR . 50
50 7 Resource Access . 51
51 7.1 General . 51
52 7.2 Addressing Uniformity . 53
53 7.3 Get . 54
54 7.4 Put . 55
55 7.5 Delete . 59
56 7.6 Create . 61
57 7.7 Fragment-Level Access . 64
58 7.8 Fragment-Level Get . 66
59 7.9 Fragment-Level Put . 67
60 7.10 Fragment-Level Delete . 70
61 7.11 Fragment-Level Create . 71
62 8 Enumeration of Datasets . 73
63 8.1 General . 73
64 8.2 Enumerate . 75
65 8.3 Filter Interpretation . 82
66 8.4 Pull . 84
67 8.5 Release . 88
68 8.6 Ad-Hoc Queries and Fragment-Level Enumerations . 90
69 8.7 Enumeration of EPRs . 90
70 8.8 Renew . 92
71 8.9 GetStatus. 94
72 8.10 EnumerationEnd . 94
73 9 Custom Actions (Methods) . 95
74 10 Notifications (Eventing) . 96
75 10.1 General . 96
76 10.2 Subscribe. 97
77 10.3 GetStatus. 117
78 10.4 Unsubscribe. 118
79 10.5 Renew . 119
80 10.6 SubscriptionEnd . 120
81 10.7 Acknowledgement of Delivery . 122
82 10.8 Refusal of Delivery . 123
83 10.9 Dropped Events . 124
84 10.10 Access Control . 125
Version 1.1.1 DMTF Standard 3
© ISO/IEC 2013 – All rights reserved
3

---------------------- Page: 6 ----------------------
ISO/IEC 17963:2013(E)
Web Services for Management (WS-Management) Specification DSP0226

85 10.11 Implementation Considerations . 126
86 10.12 Advertisement of Notifications . 126
87 11 Metadata and Discovery . 126
88 12 Security . 129
89 12.1 General . 129
90 12.2 Security Profiles . 130
91 12.3 Security Considerations for Event Subscriptions . 130
92 12.4 Including Credentials with a Subscription . 131
93 12.5 Correlating Events with a Subscription . 132
94 12.6 Transport-Level Authentication Failure . 132
95 12.7 Security Implications of Third-Party Subscriptions . 132
96 13 Transports and Message Encoding . 133
97 13.1 SOAP . 133
98 13.2 Lack of Response . 134
99 13.3 Replay of Messages . 134
100 13.4 Encoding Limits . 134
101 13.5 Binary Attachments . 135
102 13.6 Case-Sensitivity . 135
103 14 Faults . 136
104 14.1 Introduction . 136
105 14.2 Fault Encoding . 136
106 14.3 NotUnderstood Faults . 137
107 14.4 Degenerate Faults . 138
108 14.5 Fault Extensibility . 138
109 14.6 Master Faults . 139
110 ANNEX A (informative) Notational Conventions . 160
111 A.1 XML Namespaces . 160
112 ANNEX B (normative) Conformance . 162
113 ANNEX C (normative) HTTP(S) Transport and Security Profile . 163
114 C.1 General . 163
115 C.2 HTTP(S) Binding . 163
116 C.3 HTTP(S) Security Profiles . 165
117 C.4 IPSec and HTTP . 170
118 ANNEX D (informative) XPath Support . 171
119 D.1 General . 171
120 D.2 Level 1 . 172
121 D.3 Level 2 . 174
122 ANNEX E (normative) Selector Filter Dialect . 177
123 ANNEX F (informative) Identify XML Schema . 179
124 ANNEX G (informative) Resource Access Operations XML Schema and WSDL . 182
125 ANNEX H (informative) Enumeration Operations XML Schema and WSDL . 187
126 ANNEX I (informative) Notification OperationsXML Schema and WSDL . 196
127 ANNEX J (informative) Addressing XML Schema . 204
128 ANNEX K (informative) WS-Management XML Schema . 207
129 ANNEX L (informative) Change Log . 217
130
4 DMTF Standard Version 1.1.1
4
© ISO/IEC 2013 – All rights reserved

---------------------- Page: 7 ----------------------
ISO/IEC 17963:2013(E)
DSP0226 Web Services for Management (WS-Management) Specification
131 Figures
132 Figure 1 – Message Information Header Blocks . 20
133
134 Tables
135 Table 1 – Relationship Type . 21
136 Table 2 – Interoperability Requirements . 25
137 Table 3 – WSA Versions in Exchanges . 26
138 Table 4 – wsa:Action URI Descriptions . 42
139 Table 5 – wsman:AccessDenied . 139
140 Table 6 – wsa:ActionNotSupported . 140
141 Table 7 – wsman:AlreadyExists . 140
142 Table 8 – wsmen:CannotProcessFilter . 141
143 Table 9 – wsman:CannotProcessFilter . 141
144 Table 10 – wsman:Concurrency . 142
145 Table 11 – wsme:DeliveryModeRequestedUnavailable . 142
146 Table 12 – wsman:DeliveryRefused . 143
147 Table 13 – wsa:DestinationUnreachable . 143
148 Table 14 – wsman:EncodingLimit . 144
149 Table 15 – wsa:EndpointUnavailable . 145
150 Table 16 – wsman:EventDeliverToUnusable . 145
151 Table 17 – wsme:EventSourceUnableToProcess . 146
152 Table 18 – wsmen:FilterDialectRequestedUnavailable . 146
153 Table 19 – wsme:FilteringNotSupported . 146
154 Table 20 – wsmen:FilteringNotSupported . 147
155 Table 21 – wsme:FilteringRequestedUnavailable . 147
156 Table 22 – wsman:FragmentDialectNotSupported . 148
157 Table 23 – wsman:InternalError . 148
158 Table 24 – wsman:InvalidBookmark . 149
159 Table 25 – wsmen:InvalidEnumerationContext . 149
160 Table 26 – wsme:InvalidExpirationTime . 150
161 Table 27 – wsmen:InvalidExpirationTime . 150
162 Table 28 – wsme:InvalidMessage . 151
163 Table 29 – wsa:InvalidMessageInformationHeader . 151
164 Table 30 – wsman:InvalidOptions . 152
165 Table 31 – wsman:InvalidParameter . 152
166 Table 32 – wsmt:InvalidRepresentation . 153
167 Table 33 – wsman:InvalidSelectors . 153
168 Table 34 – wsa:MessageInformationHeaderRequired . 154
169 Table 35 – wsman:NoAck . 154
170 Table 36 – wsman:QuotaLimit . 154
171 Table 37 – wsman:SchemaValidationError . 155
Version 1.1.1 DMTF Standard 5
© ISO/IEC 2013 – All rights reserved
5

---------------------- Page: 8 ----------------------
ISO/IEC 17963:2013(E)
Web Services for Management (WS-Management) Specification DSP0226

172 Table 38 – wsmen:TimedOut . 155
173 Table 39 – wsman:TimedOut . 155
174 Table 40 – wsme:UnableToRenew . 156
175 Table 41 – wsme:UnsupportedExpirationType . 156
176 Table 42 – wsmen:UnsupportedExpirationType . 156
177 Table 43 – wsman:UnsupportedFeature . 157
178 Table 44 – wsme:UnsupportedExpirationType . 158
179 Table 45 – wsmen:UnableToRenew . 158
180 Table 46 – wsa:InvalidMessage . 158
181 Table 47 – wsme:CannotProcessFilter . 159
182 Table A-1 – Prefixes and XML Namespaces Used in This Specification . 161
183 Table C-1 – Basic Authentication Sequence . 165
184 Table C-2 – Digest Authentication Sequence . 166
185 Table C-3 – Basic Authentication over HTTPS Sequence . 166
186 Table C-4 – Digest Authentication over HTTPS Sequence . 167
187 Table C-5 – HTTPS with Client Certificate Sequence . 167
188 Table C-6 – Basic Authentication over HTTPS with Client Certificate Sequence . 168
189 Table C-7 – SPNEGO Authentication over HTTPS Sequence . 169
190 Table C-8 – SPNEGO Authentication over HTTPS with Client Certificate Sequence . 169
191 Table D-1 – XPath Level 1 Terminals . 173
192 Table D-2 – XPath Level 2 Terminals . 175
193
6 DMTF Standard Version 1.1.1
© ISO/IEC 2013 – All rights reserved
6

---------------------- Page: 9 ----------------------
ISO/IEC 17963:2013(E)
DSP0226 Web Services for Management (WS-Management) Specification
194 Foreword
195 The Web Services for Management (WS-Management) Specification (DSP0226) was prepared by the
196 WS-Management sub-group of the WBEM Infrastructure & Protocols Working Group.
197 This International Standard makes use of functionality similar to the following W3C
198 Recommendations:
199  Web Services Eventing (WS-Eventing)
200  Web Services Transfer (WS-Transfer)
201  Web Services Enumeration (WS-Enumeration)
202 These W3C Recommendations were not available at the time WS-Management was defined, and
203 similar functionality was incorporated directly into provisions of the WS-Management specification.
204 Future revisions of WS-Management might incorporate these functions by External Reference to
205 these W3C Recommendations
206 DMTF is a not-for-profit association of industry members dedicated to promoting enterprise and
207 systems management and interoperability.
208 Acknowledgements
209 The authors wish to acknowle
...