ISO/IEC INTERNATIONAL STANDARD 19831 First edition 2015-05-01 Cloud Infrastructure Management Interface (CIMI) Model and RESTful HTTP-based Protocol An Interface for Managing Cloud Infrastructure Model d'interface de management de I'infrastructure du nuage informatique (CIMI) et protocole RESTful base HTTP - Une interface pour le management de I'infrastructure du nuage informatique Reference number ISO/IEC 19831:2015(E) IEC ISO International Organization for Standardization ndardization 5956617 @ISO/IEC2015 se from IHS ISO/IEC 19831:2015(E) COPYRIGHT PROTECTED DOCUMENT ?ISO/IEC2015 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. ISO copyright office Case postale 56 . CH-1211 Geneva 20 Tel. + 41 22 749 01 11 Fax + 41 22 749 09 47 E-mail [email protected] Web www.iso.org Published in Switzerland vided by IHS unde ted withoutlicensefrom IHS ISO/IEC 19831:2015 (E) 33 CONTENTS 34 Foreword 35 Scope 9 36 1.1 Document structure. 9 37 1.2 Document versioning scheme 38 1.3 Typographical conventions 9 39 2 Normative references. 10 40 3 Terms and definitions 11 41 4 HTTP-based protocol.. 14 42 4.1 Introduction.. 43 4.1.1 Protocol evolution and client expectations 14 44 4.1.2 XML namespaces 45 4.1.3 URI space..... 46 4.1.4 Media types. 47 4.1.5 Request headers... 48 4.1.6 Request query parameters . 15 49 4.2 Protocol operations... 50 4.2.1 CommonCRUDoperations.... 51 4.3 OVF support... .29 52 5 53 5.1 Resource wrappers .30 54 5.2 Extensibility 55 5.3 Identifiers .... 56 5.4 Attribute constraints 32 57 5.5 Data types and their serialization. 58 5.5.1 boolean 59 5.5.2 dateTime .33 60 5.5.3 duration 61 5.5.4 integer 34 62 5.5.5 string .34 63 5.5.6 64 5.5.7 map 35 65 5.5.8 structure 66 5.5.9 byte[] 36 67 5.5.10 .36 68 5.5.11 Arrays.... 69 5.5.12 Collections 37 70 5.5.13 "Any" type 41 71 5.5.14 Empty attribute values 72 5.6 Units. 73 5.7 Relationship semantics 74 5.8 75 5.9 Alternativemodelformats .43 76 5.10 Resources... .43 77 5.10.1 Common attributes... 78 5.11 Resourcemetadata. 45 79 5.11.1 Serialization of attribute value constraints ..49 80 5.11.2 Capabilities 51 81 5.11.3 ResourceMetadataCollection Resource .54 82 5.12 Cloud Entry Point... 55 83 .61 84 5.13 System Resources and relationships 85 5.13.1 System..... ..62 @ ISO/IEC 2015-All rights reserved 3 International Organization for Standardization nitted without license from IHS ISO/IEC 19831:2015 (E) 86 5.13.2 SystemCollection Resource.. 87 5.13.3 SystemTemplate Resource .81 88 5.13.4 SystemTemplateCollectionResource .87 89 5.14 Machine Resources and relationships 90 5.14.1 Machine 91 5.14.2 MachineCollection.. .107 92 5.14.3 MachineTemplate .... .109 93 5.14.4 MachineTemplateCollection Resource 116 94 5.14.5 MachineConfiguration Resource 117 95 5.14.6 MachineConfigurationCollection Resource 96 5.14.7 Machinelmage Resource... .120 97 5.14.8 MachinelmageCollection Resource 124 98 5.14.9 Credential Resource .... 125 99 5.14.10 CredentialCollection Resource 126 100 101 5.14.12 CredentialTemplateCollection Resource 128 102 5.15 Volume Resources and relationships 130 103 5.15.1 Volume.... .131 104 5.15.2 VolumeCollection Resource 135 105 5.15.3 VolumeTemplate Resource .... 106 5.15.4 VolumeTemplateCollection Resource .138 107 5.15.5 VolumeConfiguration Resource. .139 108 5.15.6 VolumeConfigurationCollection Resource ... .141 109 5.15.7 Volumelmage Resource. 142 110 5.15.8 VolumelmageCollection Resource 144 111 5.16 NetworkResourcesandrelationships .145 112 5.16.1 Network.. .145 113 5.16.2 NetworkCollection Resource .153 114 5.16.3 NetworkTemplate Resource 154 115 5.16.4 NetworkTemplateCollectionResource 156 116 5.16.5 NetworkConfiguration Resource.... ....157 117 5.16.6 NetworkConfigurationCollection Resource. .158 118 5.16.7 NetworkPort .160 119 5.16.8 NetworkPortCo