<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" lang="en-US"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>CreateResource - AWS Cloud Control API</title><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="assets_root" content="/assets"><meta name="target_state" content="API_CreateResource"><meta name="default_state" content="API_CreateResource"><link rel="icon" type="image/ico" href="/assets/images/favicon.ico"><link rel="shortcut icon" type="image/ico" href="/assets/images/favicon.ico"><link rel="canonical" href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_CreateResource.html"><meta name="description" content="Creates the specified resource. For more information, see Creating a resource in the AWS Cloud Control API User Guide ."><meta name="deployment_region" content="IAD"><meta name="product" content="AWS Cloud Control API"><meta name="guide" content="API Reference"><meta name="abstract" content="This is the API Reference for AWS Cloud Control API. With Cloud Control API, you can create, read, update, delete, and list (CRUD-L) your cloud resources that belong to AWS and third-party services. With the Cloud Control API standardized set of application programming interfaces (APIs), you can perform CRUD-L operations on any supported resources in your AWS account. Using Cloud Control API, you won't have to generate code or scripts specific to each individual service responsible for those resources."><meta name="guide-locale" content="en_us"><meta name="tocs" content="toc-contents.json"><link rel="canonical" href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_CreateResource.html"><link rel="alternate" href="https://docs.aws.amazon.com/id_id/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="id-id"><link rel="alternate" href="https://docs.aws.amazon.com/id_id/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="id"><link rel="alternate" href="https://docs.aws.amazon.com/de_de/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="de-de"><link rel="alternate" href="https://docs.aws.amazon.com/de_de/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="de"><link rel="alternate" href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="en-us"><link rel="alternate" href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="en"><link rel="alternate" href="https://docs.aws.amazon.com/es_es/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="es-es"><link rel="alternate" href="https://docs.aws.amazon.com/es_es/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="es"><link rel="alternate" href="https://docs.aws.amazon.com/fr_fr/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="fr-fr"><link rel="alternate" href="https://docs.aws.amazon.com/fr_fr/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="fr"><link rel="alternate" href="https://docs.aws.amazon.com/it_it/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="it-it"><link rel="alternate" href="https://docs.aws.amazon.com/it_it/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="it"><link rel="alternate" href="https://docs.aws.amazon.com/ja_jp/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="ja-jp"><link rel="alternate" href="https://docs.aws.amazon.com/ja_jp/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="ja"><link rel="alternate" href="https://docs.aws.amazon.com/ko_kr/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="ko-kr"><link rel="alternate" href="https://docs.aws.amazon.com/ko_kr/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="ko"><link rel="alternate" href="https://docs.aws.amazon.com/pt_br/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="pt-br"><link rel="alternate" href="https://docs.aws.amazon.com/pt_br/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="pt"><link rel="alternate" href="https://docs.aws.amazon.com/zh_cn/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="zh-cn"><link rel="alternate" href="https://docs.aws.amazon.com/zh_tw/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="zh-tw"><link rel="alternate" href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_CreateResource.html" hreflang="x-default"><meta name="feedback-item" content="CloudFormation"><meta name="this_doc_product" content="AWS Cloud Control API"><meta name="this_doc_guide" content="API Reference"> <script defer="" src="/assets/r/awsdocs-doc-page.2.0.0.js"></script><link href="/assets/r/awsdocs-doc-page.2.0.0.css" rel="stylesheet"><script defer="" id="awsc-panorama-bundle" type="text/javascript" src="https://prod.pa.cdn.uis.awsstatic.com/panorama-nav-init.js" data-config="{'appEntity':'aws-documentation','region':'us-east-1','service':'cloudcontrolapi'}"></script><meta id="panorama-serviceSubSection" value="API Reference"><meta id="panorama-serviceConsolePage" value="CreateResource"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/9436.80242c6b78ffcd66f0e0.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/5393.f6d3da218f3c004eda1c.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/9181.d1165b10619351f4782d.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/5720.64aebf60b561d3124e63.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/5112.0080d42b0dd1f58b216c.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/5955.4f073d3bea65c0f971ed.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/5601.555e45574bdf2c2b326b.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/3486.a53c37b623013ebdef11.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/8763.e53c9a153e331f50be87.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/6208.da74153073836e32f9ac.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/5999.422bee42a3bea0e09add.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/8903.6a8fb9db87ab5fa336da.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/3708.1abf383dfb7f28a7a55e.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/1622.8ec9b5e47054f595a76e.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/5257.70aca8a45556d6cefdf4.css"><link rel="stylesheet" type="text/css" href="https://docs.aws.amazon.com/assets/r/5521.42b1fb4009ddb2afc2db.css"><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-i-open-c{display:inline-block;vertical-align:middle;line-height:1em;padding-left:.3em}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-i-open-c svg{stroke-width:2px;pointer-events:none;fill:none;padding-bottom:1px;height:10px;width:10px}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-i-open-c svg .awsccc-stroke-linecap-square{stroke-linecap:square}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-i-open-c svg .awsccc-stroke-linejoin-round{stroke-linejoin:round}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-i-open-c svg path{stroke:currentColor}</style><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-link{color:#0073bb}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-link span{color:#0073bb}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-link svg{height:16px;width:16px}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-link{color:#44b9d6}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-link span{color:#44b9d6}</style><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-btn{flex:0 1 100%;padding:4px 20px;box-sizing:border-box;border:0;background-color:#fff;border:1px solid #545b64;color:#545b64;font-weight:700;border-radius:2px;cursor:pointer;user-select:none;display:inline-block;text-align:center;font-size:14px;position:relative}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-btn:hover{background-color:#fafafa}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-btn:focus{outline:none;text-decoration:none}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-btn:focus::before{content:" ";display:block;position:absolute;left:-2px;top:-2px;width:calc(100% + 4px);height:calc(100% + 4px);border-radius:2px;box-shadow:0 0 0 2px #00a1c9}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-btn span{line-height:22px}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-btn.awsccc-u-btn-primary{background-color:#f90;border-color:#f90}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-btn.awsccc-u-btn-primary span{color:#0f141a}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-btn.awsccc-u-btn-primary:hover{background-color:#ec7211;border-color:#ec7211}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-btn.awsccc-u-btn-link{background-color:rgba(0,0,0,0);border-color:rgba(0,0,0,0);color:#545b64}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-btn.awsccc-u-btn-link:hover{color:#000;background-color:#fafafa}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-btn-primary{background-color:#f90;border-color:#f90}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-btn-primary span{color:#16191f}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-btn-primary:hover{background-color:#ec7211;border-color:#ec7211}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-btn-secondary{color:#d5dbdb;background-color:#2a2e30;border-color:#879596}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-btn-secondary:hover{background-color:#21252c}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-btn-link{color:#eaeded}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-btn-link:hover{color:#eaeded;background-color:#21252c}</style><style>#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c{position:fixed;bottom:0;left:0;width:100%;z-index:10000}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-content{position:relative;background:linear-gradient(180deg, rgba(21, 28, 39, 0.98) 0%, rgba(38, 51, 77, 0.98) 100%);box-shadow:0px -2px 5px 0px rgba(0,0,0,.5);padding:30px 30px 15px;border-top:solid 1px #306da3;display:flex;flex-direction:column}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-text-section{display:flex;flex-direction:column;flex-shrink:1;padding:0px}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-title{font-weight:700;padding:0 0 5px;margin:0;color:#fff}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-buttons{display:flex;justify-content:center;flex-wrap:wrap}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-buttons .awsccc-u-btn{margin-bottom:15px;padding-left:20px;padding-right:20px}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-text{flex:1 1 100%;margin:0 0 15px;color:#eaeded}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-text span{color:#eaeded}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c.awsc-bot-above-f-imp{z-index:1005}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c.dark-mode-enabled #awsccc-cb-content{background:none;background-color:#2a2e33}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c.dark-mode-enabled .awsccc-u-btn-secondary{background-color:#2a2e33}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c.dark-mode-enabled .awsccc-u-btn-secondary span{color:#d5dbdb}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c.dark-mode-enabled .awsccc-u-btn-secondary:hover{background-color:#21252c}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c.dark-mode-enabled .awsccc-u-btn-primary span{color:#16191f}@media screen and (min-width: 810px){#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-content{padding-bottom:30px;padding-left:20px;padding-right:20px;display:flex;justify-content:space-between}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-buttons .awsccc-u-btn{flex:1 0 25%;margin:10px 5px 0;min-width:240px}}@media screen and (min-width: 1020px){#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-content{flex-direction:row;padding-left:40px;padding-right:40px}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-actions{display:flex;justify-content:center;align-items:center}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-text{flex:1;padding-right:40px}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-buttons .awsccc-u-btn{flex:0 1 auto;margin:10px 5px 0}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-buttons{flex-wrap:nowrap;display:flex;flex-direction:column;gap:10px;width:max-content}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cb-c #awsccc-cb-buttons .awsccc-u-btn{margin-top:0}}@media screen and (min-width: 1020px){#awsccc-sb-ux-c #awsccc-sb-a.awsccc-Rtl #awsccc-cb-text{padding-left:40px;padding-right:0}}div[data-id=awsccc-cb]{display:none}</style><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cl{display:flex;flex-direction:column}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cl-c{padding:10px;border-block-end:1px solid #eaeded}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cl-c:first-of-type{padding-top:0}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cl-c:last-of-type{padding-bottom:0;border-block-end:none}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-cl-c{border-color:#414750}</style><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-container{display:flex;align-items:center;justify-content:center;bottom:0;left:0;right:0;top:0;position:fixed;outline:0;overflow:hidden;z-index:10002}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-backdrop{background-color:rgba(242,243,243,.9019607843);position:fixed;z-index:10001;right:0;top:0;bottom:0;left:0}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal{box-sizing:border-box;outline:none;margin:10px;background-color:#fff;border-radius:0;box-sizing:border-box;z-index:10002;position:relative;box-shadow:0 1px 1px 0 rgba(0,28,36,.3),1px 1px 1px 0 rgba(0,28,36,.15),-1px 1px 1px 0 rgba(0,28,36,.15)}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal[dir=rtl] *{direction:rtl;text-align:right}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal.awsccc-u-modal-large{max-width:820px;width:calc(100vw - 20px)}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-header{background-color:#fafafa;border-bottom:1px solid #eaeded;color:#16191f;padding:19px 20px;word-break:break-word;flex:auto}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-header h2{font-size:18px;font-weight:700;margin:0}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-content{overflow-y:auto;max-height:calc(100vh - 200px);padding:19px 20px}@media screen and (max-width: 480px){#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-content{max-height:calc(100vh - 275px)}}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-footer{border-top:1px solid #eaeded;text-decoration:none;padding:10px 20px;text-align:right;display:flex;justify-content:flex-end;flex-wrap:wrap}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-footer button{white-space:nowrap}@media screen and (max-width: 699px){#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-footer button{white-space:initial}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-footer>div{width:100%}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-modal-footer .awsccc-u-sb{display:flex;flex-direction:column}}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-modal-backdrop{background-color:rgba(22,25,31,.8)}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-modal{background-color:#2a2e33}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-modal-header{background-color:#21252c;border-bottom-color:#414750;color:#eaeded}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-modal-content{color:#eaeded}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-modal-footer{border-top-color:#414750}</style><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-sb{display:flex;flex-direction:row}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-sb.awsccc-u-sb-v{flex-direction:column}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-sb.awsccc-u-sb-xxs{gap:4px}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-sb.awsccc-u-sb-xs{gap:8px}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-sb.awsccc-u-sb-s{gap:12px}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-sb.awsccc-u-sb-m{gap:16px}</style><style>#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cs-info-container span,#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cs-info-container a{font-size:15px}</style><style>#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cs-l-container span,#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cs-l-container a{font-size:12px;line-height:15px}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cs-l-container span:focus,#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cs-l-container a:focus{outline-style:solid;outline-color:#00a1c9;outline-width:2px}#awsccc-sb-ux-c #awsccc-sb-a #awsccc-cs-l-container p>span{color:#687078}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled #awsccc-cs-l-container span{color:#eaeded}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled #awsccc-cs-l-container span a{display:inline-block}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled #awsccc-cs-l-container span a span{color:#44b9d6}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled #awsccc-cs-l-container path{color:#44b9d6}</style><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-s-cb-hidden{text-indent:-9999px;position:absolute}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cb-label{position:relative;display:inline-block;line-height:0}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cb-text{line-height:16px;vertical-align:top;overflow-wrap:break-word}#awsccc-sb-ux-c #awsccc-sb-a .awscc-u-cb-checkbox,#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cb-input{height:14px;width:14px;z-index:1;pointer-events:none;fill:none}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-s-cb-outer{margin-right:8px;height:14px;width:14px;display:inline-block}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cb-input{padding:0;margin:0;position:absolute;z-index:0;opacity:0}#awsccc-sb-ux-c #awsccc-sb-a .awscc-u-cb-checkbox-rect{background-color:#fff;fill:#fff;stroke:#687078;stroke-width:1}#awsccc-sb-ux-c #awsccc-sb-a .awscc-u-cb-checkbox-poly-line{opacity:1;stroke:#fff;stroke-width:2;fill:none}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cb-checkbox-active .awscc-u-cb-checkbox-rect{fill:#0073bb;stroke:#0073bb}#awsccc-sb-ux-c #awsccc-sb-a .awscc-u-cb-checkbox-container{position:relative;line-height:0}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cb-focused:before{content:" ";display:block;position:absolute;left:-2px;top:-2px;width:calc(100% + 4px);height:calc(100% + 4px);border-radius:2px;box-shadow:0 0 0 2px #00a1c9}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cb-gpc-disabled .awscc-u-cb-checkbox{opacity:.5}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-cb-gpc-disabled .awscc-u-cb-checkbox .awscc-u-cb-checkbox-rect{fill:#f2f3f3;stroke:#d5dbdb}#awsccc-sb-ux-c #awsccc-sb-a.awsccc-Rtl .awsccc-cs-s-cb-outer{margin-left:8px;margin-right:0}</style><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-sec-container{position:relative;overflow-wrap:break-word;word-wrap:break-word}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-sec-container .awsccc-cs-s-title{font-size:18px;line-height:20px;flex:0 0 100%;margin:0 0 5px;z-index:10;display:inline-block;line-height:normal;font-weight:400}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-sec-container .awsccc-cs-s-text{flex:0 0 80%;padding-top:5px}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-sec-container .awsccc-cs-s-action{display:flex;justify-content:flex-end;flex:1;position:relative;margin-top:8px;margin-bottom:8px}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-sec-container .awsccc-cs-s-paragraph{margin-top:0;font-size:14px;line-height:20px;padding:0;margin-bottom:15px}@media screen and (min-width: 700px){#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-sec-container{display:flex;flex-wrap:wrap}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-sec-container .awsccc-cs-s-title{padding-bottom:0}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-sec-container .awsccc-cs-s-text{border-top:0}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cs-sec-container .awsccc-cs-s-action{justify-content:center;position:relative;top:auto;right:auto;padding-top:20px}}</style><style>#awsccc-sb-ux-c #awsccc-sb-a{font-family:"Amazon Ember","HelveticaNeue","Helvetica Neue","Amazon Ember",Roboto,"Roboto-Regular","Amazon Ember",Helvetica,Arial,sans-serif;font-size:14px;line-height:21px;color:#16191f;text-align:left}#awsccc-sb-ux-c #awsccc-sb-a *{background:none;border:0}#awsccc-sb-ux-c #awsccc-sb-a.awsccc-Rtl *{direction:rtl;text-align:right}@media screen and (min-width: 1020px){#awsccc-sb-ux-c #awsccc-sb-a.awsccc-Rtl #awsccc-cb-c #awsccc-cb-title{padding-right:40px}}#awsccc-sb-ux-c #awsccc-sb-a a,#awsccc-sb-ux-c #awsccc-sb-a a>span,#awsccc-sb-ux-c #awsccc-sb-a a svg path{color:#0073bb;text-decoration:underline;font-weight:700}#awsccc-sb-ux-c #awsccc-sb-a a:hover,#awsccc-sb-ux-c #awsccc-sb-a a>span:hover,#awsccc-sb-ux-c #awsccc-sb-a a svg path:hover{color:#0073bb;text-decoration:underline}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled{color-scheme:dark}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled a,#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled a>span,#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled a svg path{color:#44b9d6;text-decoration:underline;font-weight:700}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled a:hover,#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled a>span:hover,#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled a svg path:hover{color:#44b9d6}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-tab-helper{outline:0;text-decoration:none}body.awsccc-modal-open{overflow:hidden;-webkit-box-sizing:border-box;box-sizing:border-box}.awsccc-gpc-warning{background-color:#fef7e6;border:1px solid #f0c744;border-radius:4px;padding:12px 16px;margin:8px 0}.awsccc-gpc-warning strong{display:block;margin-bottom:4px;color:#8d6605}.awsccc-gpc-warning p{margin:0;color:#5f4204;font-size:14px;line-height:1.5}.dark-mode-enabled .awsccc-gpc-warning{background-color:#3d2f00;border-color:#7d6200}.dark-mode-enabled .awsccc-gpc-warning strong{color:#f9dc5c}.dark-mode-enabled .awsccc-gpc-warning p{color:#e8d08a}</style><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-field{display:flex;flex-direction:column;gap:4px}</style><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-rg>label{position:relative}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-rg input[type=radio]{opacity:0;user-select:none;cursor:default;position:absolute}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-rg .awsccc-u-rg-radio{display:inline-block;box-sizing:content-box;position:relative;vertical-align:middle;height:14px;width:14px;border-radius:50%;background-color:#fff;border:2px solid #7d8998;transition:background-color ease .15s,border-color ease .15s}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-rg .awsccc-u-rg-radio::before{position:absolute;content:"";height:6px;width:6px;border-radius:50%;top:4px;left:4px;transition:background-color ease .15s}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-rg .awsccc-u-rg-radio+span{padding-inline-start:8px;vertical-align:middle}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-rg input:checked+.awsccc-u-rg-radio{background-color:#0073bb;border-color:#0073bb}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-rg input:checked+.awsccc-u-rg-radio::before{background-color:#fff}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-u-rg input:focus-visible+.awsccc-u-rg-radio{outline:2px solid #00a1c9;outline-offset:2px}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled .awsccc-u-rg-radio{background-color:#1a2029;border-color:#879596}#awsccc-sb-ux-c #awsccc-sb-a .dark-mode-enabled input:checked+.awsccc-u-rg-radio{background-color:#00a1c9;border-color:#00a1c9}</style><style>#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cbbas-c{overflow-wrap:break-word;word-wrap:break-word}#awsccc-sb-ux-c #awsccc-sb-a .awsccc-cbbas-c p{margin:0;overflow-wrap:break-word}.awsccc-gpc-warning{background-color:#fef7e6;border-left:4px solid #f89406;padding:12px;margin-bottom:16px}.awsccc-gpc-warning strong{display:block;margin-bottom:8px;color:#333}.awsccc-gpc-warning p{margin:0;color:#666;font-size:14px;line-height:1.5}.dark-mode-enabled .awsccc-gpc-warning{background-color:#3d2f00;border-color:#7d6200}.dark-mode-enabled .awsccc-gpc-warning strong{color:#f9dc5c}.dark-mode-enabled .awsccc-gpc-warning p{color:#e8d08a}</style><script charset="utf-8" data-webpack="@amzn/aws-docs-website-assets-react:chunk-7292" src="https://docs.aws.amazon.com/assets/r/7292.394d51fb792fe4a26326.js"></script></head>
<body class="awsdocs awsui awsui-visual-refresh"><div class="awsdocs-container"><p><a href="API_CreateResource.md">View a markdown version of this page</a></p><awsdocs-header></awsdocs-header><awsui-app-layout id="app-layout" class="awsui-util-no-gutters" ng-controller="ContentController as $ctrl" header-selector="awsdocs-header" navigation-hide="false" navigation-width="$ctrl.navWidth" navigation-open="$ctrl.navOpen" navigation-change="$ctrl.onNavChange($event)" tools-hide="$ctrl.hideTools" tools-width="$ctrl.toolsWidth" tools-open="$ctrl.toolsOpen" tools-change="$ctrl.onToolsChange($event)"><div id="guide-toc" dom-region="navigation"><awsdocs-toc></awsdocs-toc></div><div id="main-column" dom-region="content" tabindex="-1"><awsdocs-view class="awsdocs-view"><div id="awsdocs-content"><title>CreateResource - AWS Cloud Control API</title><meta name="pdf" content="/pdfs/cloudcontrolapi/latest/APIReference/cloudcontrolapi.pdf#API_CreateResource"><meta name="forums" content="https://repost.aws/tags/TAm3R3LNU3RfSX9L23YIpo3w"><meta name="feedback" content="https://docs.aws.amazon.com/forms/aws-doc-feedback?hidden_service_name=CloudFormation&amp;topic_url=https://docs.aws.amazon.com/en_us/cloudcontrolapi/latest/APIReference/API_CreateResource.html"><meta name="feedback-yes" content="feedbackyes.html?topic_url=https://docs.aws.amazon.com/en_us/cloudcontrolapi/latest/APIReference/API_CreateResource.html"><meta name="feedback-no" content="feedbackno.html?topic_url=https://docs.aws.amazon.com/en_us/cloudcontrolapi/latest/APIReference/API_CreateResource.html"><meta name="keywords" content="API,requests,CreateResource"><link rel="alternate" type="text/markdown" href="API_CreateResource.md" title="Markdown version"><script type="application/ld+json">
{
    "@context" : "https://schema.org",
    "@type" : "BreadcrumbList",
    "itemListElement" : [
      {
        "@type" : "ListItem",
        "position" : 1,
        "name" : "AWS",
        "item" : "https://aws.amazon.com"
      },
      {
        "@type" : "ListItem",
        "position" : 2,
        "name" : "AWS Cloud Control API",
        "item" : "https://docs.aws.amazon.com/cloudcontrolapi/index.html"
      },
      {
        "@type" : "ListItem",
        "position" : 3,
        "name" : "API Reference",
        "item" : "https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference"
      },
      {
        "@type" : "ListItem",
        "position" : 4,
        "name" : "Actions",
        "item" : "https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_Operations.html"
      },
      {
        "@type" : "ListItem",
        "position" : 5,
        "name" : "CreateResource",
        "item" : "https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_Operations.html"
      }
    ]
}
</script><div id="main"><div style="display: none"><a href="/pdfs/cloudcontrolapi/latest/APIReference/cloudcontrolapi.pdf#API_CreateResource" target="_blank" rel="noopener noreferrer" title="Open PDF"></a></div><div id="breadcrumbs" class="breadcrumb"><a href="/index.html">Documentation</a><a href="/cloudcontrolapi/index.html">AWS Cloud Control API</a><a href="Welcome.html">API Reference</a></div><div id="page-toc-src"><a href="#API_CreateResource_RequestSyntax">Request Syntax</a><a href="#API_CreateResource_RequestParameters">Request Parameters</a><a href="#API_CreateResource_ResponseSyntax">Response Syntax</a><a href="#API_CreateResource_ResponseElements">Response Elements</a><a href="#API_CreateResource_Errors">Errors</a><a href="#API_CreateResource_Examples">Examples</a><a href="#API_CreateResource_SeeAlso">See Also</a></div><div id="main-content" class="awsui-util-container"><div id="main-col-body"><awsdocs-language-banner data-service="$ctrl.pageService"></awsdocs-language-banner><h1 class="topictitle" id="API_CreateResource">CreateResource</h1><div class="awsdocs-page-header-container"><awsdocs-page-header></awsdocs-page-header><awsdocs-filter-selector id="awsdocs-filter-selector"></awsdocs-filter-selector></div><p>Creates the specified resource. For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html">Creating a
        resource</a> in the <em>
         AWS Cloud Control API User Guide</em>.</p><p>After you have initiated a resource creation request, you can monitor the progress of your
      request by calling <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html">GetResourceRequestStatus</a> using the <code class="code">RequestToken</code> of the
        <code class="code">ProgressEvent</code> type returned by <code class="code">CreateResource</code>.</p>
      <h2 id="API_CreateResource_RequestSyntax">Request Syntax</h2>
      <pre class="programlisting"><div class="code-btn-container"></div><!--DEBUG: cli ()--><code class="nohighlight"><span>{</span>
   "<a href="#ccapi-CreateResource-request-ClientToken">ClientToken</a>": "<code class="replaceable">string</code>",
   "<a href="#ccapi-CreateResource-request-DesiredState">DesiredState</a>": "<code class="replaceable">string</code>",
   "<a href="#ccapi-CreateResource-request-RoleArn">RoleArn</a>": "<code class="replaceable">string</code>",
   "<a href="#ccapi-CreateResource-request-TypeName">TypeName</a>": "<code class="replaceable">string</code>",
   "<a href="#ccapi-CreateResource-request-TypeVersionId">TypeVersionId</a>": "<code class="replaceable">string</code>"
}</code></pre>
    
      <h2 id="API_CreateResource_RequestParameters">Request Parameters</h2>
      <p>For information about the parameters that are common to all actions, see <a href="./CommonParameters.html">Common Parameters</a>.</p>
      <p>The request accepts the following data in JSON format.</p>
      <div class="variablelist">
          
          
          
          
          
      <dl>
            <dt id="ccapi-CreateResource-request-ClientToken"><span class="term">
               <b>
                  <a href="#API_CreateResource_RequestSyntax">ClientToken</a>
               </b>
            </span></dt>
            <dd>
               <p>A unique identifier to ensure the idempotency of the resource request. As a
                                     best practice, specify this token to ensure idempotency, so that AWS Cloud Control API can
                                     accurately distinguish between request retries and new resource requests. You
                                     might retry a resource request to ensure that it was successfully received.</p>
               <p>A client token is valid for 36 hours once used. After that, a resource
                                     request with the same client token is treated as a new request.</p>
               <p>If you
                                     do not specify a client token, one is generated for inclusion in the request.</p>
               <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-idempotency">Ensuring
                                     resource operation requests are unique</a> in the <em>
                     AWS Cloud Control API User
                                     Guide</em>.</p>
               <p>Type: String</p>
               <p>Length Constraints: Minimum length of 1. Maximum length of 128.</p>
               <p>Pattern: <code class="code">[-A-Za-z0-9+/=]+</code>
               </p>
               <p>Required: No</p>
            </dd>
          
            <dt id="ccapi-CreateResource-request-DesiredState"><span class="term">
               <b>
                  <a href="#API_CreateResource_RequestSyntax">DesiredState</a>
               </b>
            </span></dt>
            <dd>
               <p>Structured data format representing the desired state of the resource, consisting of that
      resource's properties and their desired values.</p>
               <div class="awsdocs-note"><div class="awsdocs-note-title"><awsui-icon name="status-info" variant="link"></awsui-icon><h6>Note</h6></div><div class="awsdocs-note-text"><p>Cloud Control API currently supports JSON as a structured data format.</p></div></div>
               <p>Specify the desired state as one of the following:</p>
               <div class="itemizedlist">
                   
                   
               <ul class="itemizedlist"><li class="listitem">
                     <p>A JSON blob</p>
                  </li><li class="listitem">
                     <p>A local path containing the desired state in JSON data format</p>
                  </li></ul></div>
               <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations-create.html#resource-operations-create-desiredstate">Composing the desired state of the resource</a> in the <em>
                     AWS Cloud Control API User
        Guide</em>.</p>
               <p>For more information about the properties of a specific resource, refer to the related
      topic for the resource in the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-template-resource-type-ref.html">Resource and property types reference</a> in the <em>
                     AWS CloudFormation Template Reference</em>.</p>
               <p>Type: String</p>
               <p>Length Constraints: Minimum length of 1. Maximum length of 262144.</p>
               <p>Pattern: <code class="code">[\s\S]*</code>
               </p>
               <p>Required: Yes</p>
            </dd>
          
            <dt id="ccapi-CreateResource-request-RoleArn"><span class="term">
               <b>
                  <a href="#API_CreateResource_RequestSyntax">RoleArn</a>
               </b>
            </span></dt>
            <dd>
               <p>The Amazon Resource Name (ARN) of the AWS Identity and Access Management
                                    (IAM) role for Cloud Control API to use when performing this resource
                                    operation. The role specified must have the permissions required for this
                                    operation. The necessary permissions for each event handler are defined in the
                                    <code class="code">
                     <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers">handlers</a>
                  </code>
                                    section of the <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html">resource type
                                    definition schema</a>.</p>
               <p>If you do not specify a role, Cloud Control API uses a temporary session created using
                                    your AWS user credentials.</p>
               <p>For more information, see <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/resource-operations.html#resource-operations-permissions">Specifying
                                    credentials</a> in the <em>
                     AWS Cloud Control API User Guide</em>.</p>
               <p>Type: String</p>
               <p>Length Constraints: Minimum length of 20. Maximum length of 2048.</p>
               <p>Pattern: <code class="code">arn:.+:iam::[0-9]<span>{</span>12}:role/.+</code>
               </p>
               <p>Required: No</p>
            </dd>
          
            <dt id="ccapi-CreateResource-request-TypeName"><span class="term">
               <b>
                  <a href="#API_CreateResource_RequestSyntax">TypeName</a>
               </b>
            </span></dt>
            <dd>
               <p>The name of the resource type.</p>
               <p>Type: String</p>
               <p>Length Constraints: Minimum length of 10. Maximum length of 196.</p>
               <p>Pattern: <code class="code">[A-Za-z0-9]<span>{</span>2,64}::[A-Za-z0-9]<span>{</span>2,64}::[A-Za-z0-9]<span>{</span>2,64}</code>
               </p>
               <p>Required: Yes</p>
            </dd>
          
            <dt id="ccapi-CreateResource-request-TypeVersionId"><span class="term">
               <b>
                  <a href="#API_CreateResource_RequestSyntax">TypeVersionId</a>
               </b>
            </span></dt>
            <dd>
               <p>For private resource types, the type version to use in this resource
                                     operation. If you do not specify a resource version, CloudFormation
                                     uses the default version.</p>
               <p>Type: String</p>
               <p>Length Constraints: Minimum length of 1. Maximum length of 128.</p>
               <p>Pattern: <code class="code">[A-Za-z0-9-]+</code>
               </p>
               <p>Required: No</p>
            </dd>
         </dl></div>
    
      <h2 id="API_CreateResource_ResponseSyntax">Response Syntax</h2>
      <pre class="programlisting"><div class="code-btn-container"></div><!--DEBUG: cli ()--><code class="nohighlight"><span>{</span>
   "<a href="#ccapi-CreateResource-response-ProgressEvent">ProgressEvent</a>": <span>{</span> 
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-ErrorCode">ErrorCode</a>": "<b><em>string</em></b>",
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-EventTime">EventTime</a>": <b><em>number</em></b>,
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-HooksRequestToken">HooksRequestToken</a>": "<b><em>string</em></b>",
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-Identifier">Identifier</a>": "<b><em>string</em></b>",
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-Operation">Operation</a>": "<b><em>string</em></b>",
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-OperationStatus">OperationStatus</a>": "<b><em>string</em></b>",
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-RequestToken">RequestToken</a>": "<b><em>string</em></b>",
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-ResourceModel">ResourceModel</a>": "<b><em>string</em></b>",
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-RetryAfter">RetryAfter</a>": <b><em>number</em></b>,
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-StatusMessage">StatusMessage</a>": "<b><em>string</em></b>",
      "<a href="./API_ProgressEvent.html#ccapi-Type-ProgressEvent-TypeName">TypeName</a>": "<b><em>string</em></b>"
   }
}</code></pre>
    
      <h2 id="API_CreateResource_ResponseElements">Response Elements</h2>
      <p>If the action is successful, the service sends back an HTTP 200 response.</p>
      <p>The following data is returned in JSON format by the service.</p>
      <div class="variablelist">
          
      <dl>
            <dt id="ccapi-CreateResource-response-ProgressEvent"><span class="term">
               <b>
                  <a href="#API_CreateResource_ResponseSyntax">ProgressEvent</a>
               </b>
            </span></dt>
            <dd>
               <p>Represents the current status of the resource creation request.</p>
               <p>After you have initiated a resource creation request, you can monitor the progress of your
      request by calling <a href="https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html">GetResourceRequestStatus</a> using the <code class="code">RequestToken</code> of the
        <code class="code">ProgressEvent</code> returned by <code class="code">CreateResource</code>.</p>
               <p>Type: <a href="./API_ProgressEvent.html">ProgressEvent</a> object</p>
            </dd>
         </dl></div>
    
      <h2 id="API_CreateResource_Errors">Errors</h2>
      <p>For information about the errors that are common to all actions, see <a href="./CommonErrors.html">Common Error Types</a>.</p>
      <div class="variablelist">
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
      <dl>
            <dt><span class="term">
               <b>
                  AlreadyExistsException
               </b>
            </span></dt>
            <dd>
               <p>The resource with the name requested already exists.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  ClientTokenConflictException
               </b>
            </span></dt>
            <dd>
               <p>The specified client token has already been used in another resource request.</p>
               <p>It's best practice for client tokens to be unique for each resource operation request.
      However, client token expire after 36 hours.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  ConcurrentOperationException
               </b>
            </span></dt>
            <dd>
               <p>Another resource operation is currently being performed on this resource.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  GeneralServiceException
               </b>
            </span></dt>
            <dd>
               <p>The resource handler has returned that the downstream service generated an error that
      doesn't map to any other handler error code.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  HandlerFailureException
               </b>
            </span></dt>
            <dd>
               <p>The resource handler has failed without a returning a more specific error code. This can
      include timeouts.</p>
               <p>HTTP Status Code: 500</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  HandlerInternalFailureException
               </b>
            </span></dt>
            <dd>
               <p>The resource handler has returned that an unexpected error occurred within the resource
      handler.</p>
               <p>HTTP Status Code: 500</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  InvalidCredentialsException
               </b>
            </span></dt>
            <dd>
               <p>The resource handler has returned that the credentials provided by the user are
      invalid.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  InvalidRequestException
               </b>
            </span></dt>
            <dd>
               <p>The resource handler has returned that invalid input from the user has generated a generic
      exception.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  NetworkFailureException
               </b>
            </span></dt>
            <dd>
               <p>The resource handler has returned that the request couldn't be completed due to networking
      issues, such as a failure to receive a response from the server.</p>
               <p>HTTP Status Code: 500</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  NotStabilizedException
               </b>
            </span></dt>
            <dd>
               <p>The resource handler has returned that the downstream resource failed to complete all of
      its ready-state checks.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  NotUpdatableException
               </b>
            </span></dt>
            <dd>
               <p>One or more properties included in this resource operation are defined as create-only, and
      therefore can't be updated.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  PrivateTypeException
               </b>
            </span></dt>
            <dd>
               <p>Cloud Control API hasn't received a valid response from the resource handler, due to a configuration
      error. This includes issues such as the resource handler returning an invalid response, or
      timing out.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  ResourceConflictException
               </b>
            </span></dt>
            <dd>
               <p>The resource is temporarily unavailable to be acted upon. For example, if the resource is
      currently undergoing an operation and can't be acted upon until that operation is
      finished.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  ResourceNotFoundException
               </b>
            </span></dt>
            <dd>
               <p>A resource with the specified identifier can't be found.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  ServiceInternalErrorException
               </b>
            </span></dt>
            <dd>
               <p>The resource handler has returned that the downstream service returned an internal error,
      typically with a <code class="code">5XX HTTP</code> status code.</p>
               <p>HTTP Status Code: 500</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  ServiceLimitExceededException
               </b>
            </span></dt>
            <dd>
               <p>The resource handler has returned that a non-transient resource limit was reached on the
      service side.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  ThrottlingException
               </b>
            </span></dt>
            <dd>
               <p>The request was denied due to request throttling.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  TypeNotFoundException
               </b>
            </span></dt>
            <dd>
               <p>The specified extension doesn't exist in the CloudFormation registry.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
          
            <dt><span class="term">
               <b>
                  UnsupportedActionException
               </b>
            </span></dt>
            <dd>
               <p>The specified resource doesn't support this resource operation.</p>
               <p>HTTP Status Code: 400</p>
            </dd>
         </dl></div>
    
      <h2 id="API_CreateResource_Examples">Examples</h2>
       
         <h3 id="API_CreateResource_Example_1">CreateResource</h3>
         <p>The following example creates a resource of type <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-logs-loggroup.html">AWS::Logs::LogGroup</a> named <code class="code">LogGroupResourceExample</code> and with a
          retention policy of 90 days.</p>
          
            <h4 id="API_CreateResource_Example_1_Request">Sample Request</h4>
            <pre class="programlisting"><div class="code-btn-container"></div><!--DEBUG: cli ()--><code class="">
https://cloudcontrolapi.us-east-1.amazonaws.com/
 ?Action=CreateResource
 &amp;TypeName=AWS::Logs::LogGroup
 &amp;DesiredState=<span>{</span>"LogGroupName": "LogGroupResourceExample","RetentionInDays":90}
 &amp;Version=2021-09-30
 &amp;X-Amz-Algorithm=AWS4-HMAC-SHA256
 &amp;X-Amz-Credential=[Access key ID and scope]
 &amp;X-Amz-Date=20250316T233349Z
 &amp;X-Amz-SignedHeaders=content-type;host
 &amp;X-Amz-Signature=[Signature]
         </code></pre>
          
          
            <h4 id="API_CreateResource_Example_1_Response">Sample Response</h4>
            <pre class="programlisting"><div class="code-btn-container"></div><!--DEBUG: cli ()--><code class="">
&lt;CreateResourceResponse xmlns="http://cloudcontrol.amazonaws.com/doc/2021-09-30/"&gt;
  &lt;CreateResourceResult&gt;
    &lt;ProgressEvent&gt;
      &lt;Identifier&gt;CloudApiLogGroup&lt;/Identifier&gt;
      &lt;OperationStatus&gt;IN_PROGRESS&lt;/OperationStatus&gt;
      &lt;EventTime&gt;2025-02-27T18:07:16.468Z&lt;/EventTime&gt;
      &lt;TypeName&gt;AWS::Logs::LogGroup&lt;/TypeName&gt;
      &lt;RequestToken&gt;f2fcf5a1-7f17-4c7a-b67f-ab0123456789&lt;/RequestToken&gt;
      &lt;Operation&gt;CREATE&lt;/Operation&gt;
    &lt;/ProgressEvent&gt;
  &lt;/CreateResourceResult&gt;
  &lt;ResponseMetadata&gt;
    &lt;RequestId&gt;d995ea2f-446c-4688-8656-573123456789&lt;/RequestId&gt;
  &lt;/ResponseMetadata&gt;
&lt;/CreateResourceResponse&gt;</code></pre>
          
       
    
      <h2 id="API_CreateResource_SeeAlso">See Also</h2>
      <p>For more information about using this API in one of the language-specific AWS SDKs, see the following:</p>
      <div class="itemizedlist">
          
          
          
          
          
          
          
          
          
          
      <ul class="itemizedlist"><li class="listitem">
            <p>
               <a href="https://docs.aws.amazon.com/goto/cli2/cloudcontrol-2021-09-30/CreateResource">AWS Command Line Interface V2</a>
            </p>
         </li><li class="listitem">
            <p>
               <a href="https://docs.aws.amazon.com/goto/DotNetSDKV4/cloudcontrol-2021-09-30/CreateResource">AWS SDK for .NET V4</a>
            </p>
         </li><li class="listitem">
            <p>
               <a href="https://docs.aws.amazon.com/goto/SdkForCpp/cloudcontrol-2021-09-30/CreateResource">AWS SDK for C++</a>
            </p>
         </li><li class="listitem">
            <p>
               <a href="https://docs.aws.amazon.com/goto/SdkForGoV2/cloudcontrol-2021-09-30/CreateResource">AWS SDK for Go v2</a>
            </p>
         </li><li class="listitem">
            <p>
               <a href="https://docs.aws.amazon.com/goto/SdkForJavaV2/cloudcontrol-2021-09-30/CreateResource">AWS SDK for Java V2</a>
            </p>
         </li><li class="listitem">
            <p>
               <a href="https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/cloudcontrol-2021-09-30/CreateResource">AWS SDK for JavaScript V3</a>
            </p>
         </li><li class="listitem">
            <p>
               <a href="https://docs.aws.amazon.com/goto/SdkForKotlin/cloudcontrol-2021-09-30/CreateResource">AWS SDK for Kotlin</a>
            </p>
         </li><li class="listitem">
            <p>
               <a href="https://docs.aws.amazon.com/goto/SdkForPHPV3/cloudcontrol-2021-09-30/CreateResource">AWS SDK for PHP V3</a>
            </p>
         </li><li class="listitem">
            <p>
               <a href="https://docs.aws.amazon.com/goto/boto3/cloudcontrol-2021-09-30/CreateResource">AWS SDK for Python</a>
            </p>
         </li><li class="listitem">
            <p>
               <a href="https://docs.aws.amazon.com/goto/SdkForRubyV3/cloudcontrol-2021-09-30/CreateResource">AWS SDK for Ruby V3</a>
            </p>
         </li></ul></div>
   <awsdocs-copyright class="copyright-print"></awsdocs-copyright><awsdocs-thumb-feedback right-edge="{{$ctrl.thumbFeedbackRightEdge}}"></awsdocs-thumb-feedback></div><noscript><div><div><div><div id="js_error_message"><p><img src="https://d1ge0kk1l5kms0.cloudfront.net/images/G/01/webservices/console/warning.png" alt="Warning" /> <strong>Javascript is disabled or is unavailable in your browser.</strong></p><p>To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.</p></div></div></div></div></noscript><div id="main-col-footer" class="awsui-util-font-size-0"><div id="doc-conventions"><a target="_top" href="/general/latest/gr/docconventions.html">Document Conventions</a></div><div class="prev-next"><div id="previous" class="prev-link" accesskey="p" href="./API_CancelResourceRequest.html">CancelResourceRequest</div><div id="next" class="next-link" accesskey="n" href="./API_DeleteResource.html">DeleteResource</div></div></div><awsdocs-page-utilities></awsdocs-page-utilities></div><div id="quick-feedback-yes" style="display: none;"><div class="title">Did this page help you? - Yes</div><div class="content"><p>Thanks for letting us know we're doing a good job!</p><p>If you've got a moment, please tell us what we did right so we can do more of it.</p><p><awsui-button id="fblink" rel="noopener noreferrer" target="_blank" text="Feedback" click="linkClick($event)" href="https://docs.aws.amazon.com/forms/aws-doc-feedback?hidden_service_name=CloudFormation&amp;topic_url=https://docs.aws.amazon.com/en_us/cloudcontrolapi/latest/APIReference/API_CreateResource.html"></awsui-button></p></div></div><div id="quick-feedback-no" style="display: none;"><div class="title">Did this page help you? - No</div><div class="content"><p>Thanks for letting us know this page needs work. We're sorry we let you down.</p><p>If you've got a moment, please tell us how we can make the documentation better.</p><p><awsui-button id="fblink" rel="noopener noreferrer" target="_blank" text="Feedback" click="linkClick($event)" href="https://docs.aws.amazon.com/forms/aws-doc-feedback?hidden_service_name=CloudFormation&amp;topic_url=https://docs.aws.amazon.com/en_us/cloudcontrolapi/latest/APIReference/API_CreateResource.html"></awsui-button></p></div></div></div></div></awsdocs-view><div class="page-loading-indicator" id="page-loading-indicator"><awsui-spinner size="large"></awsui-spinner></div></div><div id="tools-panel" dom-region="tools"><awsdocs-tools-panel id="awsdocs-tools-panel"></awsdocs-tools-panel></div></awsui-app-layout><awsdocs-cookie-banner class="doc-cookie-banner"></awsdocs-cookie-banner></div></body></html>