CHAPTER4-1CiscoCloudObjectStorageRelease2.
1.
1APIGuide4SwiftAPIThischapterdescribesthesubsetoftheOpenStackSwiftAPIthatisimplementedforCOS.
TheSwiftAPIusestheStorageFQDNthatisassignedtotheCOScluster.
NoteTheCOSclusterisassignedanAuthenticationFQDN(usedwiththeSwauthAPI)andaStorageFQDN(usedwiththeSwiftAPI).
CurrentlytheAuthenticationFQDNandtheStorageFQDNmustbethesame,forexample,auth01.
cos.
acme.
com.
ListingContainersToretrievealistofexistingstoragecontainers,usethefollowingHTTPGETrequest:NoteTomakethisrequest,youmustbeanaccountadminorareselleradmin.
GET/v1/[=[&=]]HTTP/1.
1ThenamesofthecontainersinthelistaresortedbasedonabinarycomparisonoftheUTF-8encodedcontainernames.
RequiredRequestHeaderX-Auth-Token:OptionalQueryParametersThefollowingparameterscanbeusedinthequery:limit—Specifiesthemaximumnumberofresultstoberetrieved.
marker—RetrievescontainernameswhosecharactershaveagreaterUnicodealphabeticalvaluethanthoseofthespecifiedstring.
end_marker—RetrievescontainernameswhosecharactershavealowerUnicodealphabeticalvaluethanthoseofthespecifiedstring.
prefix—Retrievescontainernamesbeginningwiththespecifiedcharacters.
4-2CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIListingObjectsdelimiter—Retrievescontainernamesthatdonothavethespecifiedcharacter,exceptintheprefix,ifany.
format—Specifieseitherjsonorxmlastheformatoftheserializedresponse.
ListingObjectsTolisttheobjectsinthestoragecontainer,usethefollowingHTTPGETrequest:NoteTomakethisrequest,youmustbeanaccountadministratororCOSreseller-administrator.
Or,ifaread-ACLhasbeenspecifiedforacontainer,eitheryoumusthavebeenassignedarolelistedintheACL,or'*'mustbelistedasarole,permittinganonymousaccess.
GET/v1//[=[&=]]HTTP/1.
1ThenamesoftheobjectsinthelistaresortedbasedonabinarycomparisonoftheUTF-8encodedobjectnames.
OptionalQueryParametersThefollowingparameterscanbeusedinthequery:limit—Specifiesthemaximumnumberofresultstoberetrieved.
marker—RetrievesobjectnameswhosecharactershaveagreaterUnicodealphabeticalvaluethanthoseofthespecifiedstring.
end_marker—RetrievesobjectnameswhosecharactershavealowerUnicodealphabeticalvaluethanthoseofthespecifiedstring.
prefix—Retrievesobjectnamesbeginningwiththespecifiedcharacters.
delimiter—Retrievesobjectnamesthatdonothavethespecifiedcharacter,exceptintheprefix,ifany.
path—Retrievesnamesofobjectsnestedinthespecifiedpath.
format—Specifieseitherjsonorxmlastheformatoftheserializedresponse.
NoteIfaresponseformatisnotspecifiedasaqueryparameter,alistofobjectnamesisreturnedintheresponsebody,onenameperline.
ResponseStatusCodesTheresponsestatuscodeisoneofthefollowing:4-3CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPICreatingaContainer2xx—indicatesasuccessfulexecutionoftherequest.
204(NoContent)—indicatesthateitherthecontainerisempty,ornoneoftheobjectsinthecontainermatchthequeryparametersspecifiedintherequest.
CreatingaContainerTocreateastoragecontainer,usethefollowingHTTPPUTrequest:NoteTomakethisrequest,youmustbeanaccountadmin,aCOSreselleradminorthesuperadmin.
PUT/v1//HTTP/1.
1Thenameofthecontainermustadheretothefollowingrestrictions:Thenamecannotincludetheforwardslash(/)characterortheencodedforwardslashcharacter(%2For%2f).
Thenameshouldnotexceed256byteswhenitisencodedinURL.
RequiredRequestHeaderX-Auth-Token:OptionalRequestHeadersX-Container-Read:X-Container-Write:AssigningCustomAttributesToassigncustomattributestoastoragecontainer,includeadditionalHTTPheadersintheHTTPPUTrequestshownabove.
Theadditionalheadersshouldbeofthefollowingform:X-Container-Meta-:ResponseStatusCodesTheresponsestatuscodeisoneofthefollowing:201(Created)—Thecontainerwascreated.
202(Accepted)—Thecontaineralreadyexists.
400(BadRequest)—Invalidcontainername.
401(Unauthorized)—Theusertokenismissingorinvalid.
403(Forbidden)—Theuserdoesnothavepermissiontocreatethecontainer.
404(NotFound)—ThestorageURLreferencesanon-existentaccount.
4-4CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIDeletingaContainerDeletingaContainerTopermanentlyremoveastoragecontainer,usethefollowingHTTPDELETErequest:NoteTomakethisrequest,youmustbeanaccountadmin,areselleradmin,orthesuperadmin.
DELETE/v1//HTTP/1.
NoteOnlyemptystoragecontainerscanbedeleted.
RequiredRequestHeaderX-Auth-Token:ResponseStatusCodesTheresponsestatuscodeisoneofthefollowing:204(NoContent)—Thecontainerwasdeleted.
400(BadRequest)—Invalidcontainername.
401(Unauthorized)—Theusertokenismissingorinvalid.
403(Forbidden)—Theuserdoesnothavepermissiontodeletethecontainer.
404(NotFound)—ThestorageURLreferencesanon-existentaccount.
409(Conflict)—Thecontainerisnotempty.
RetrievinganObjectToretrievethedataofanobject,usethefollowingHTTPGETrequest:NoteTomakethisrequest,youmustbeanaccountadminorCOSreseller-admin;orifaread-ACLhasbeenspecifiedforthecontainer,eitheryouareassignedarolelistedintheACL,or*isspecifiedasarole,permittinganonymousaccess.
GET/v1///HTTP/1.
1NoteYoumayretrievedatafromanobjectwhileitisbeingcreated.
Ifyoudo,theresponsewillhavetheX-Object-Is-Dynamic:yesheader.
RequiredRequestHeaderX-Auth-Token:4-5CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIRetrievinganObjectNoteIfthecontainerread-ACLpermitsanonymousaccess,thisheaderisnotrequired.
OptionalRequestHeadersX-Follow-Redirect:true–Iftherequesthasthisheader,theCOSnodemayrespondwitha307(TemporaryRedirect)codeandincludeaLocationresponseheaderhavingtheURLatwhichtheclientshouldretrytherequest.
–Iftherequestdoesnothavethisheader,orthevalueoftheheaderisnottrue,theCOSnodereceivingtherequestwillrespondwiththerequestedobject.
NoteTheX-Follow-RedirectrequestheaderisaCOSextension.
X-Transfer-Rate:–Thisheaderspecifiesatransferrateindecimalbitspersecond.
–Validrangeofvaluesforthisheaderis400000to50000000,thatis,400Kbpsto50Mbps.
–Iftheheaderisnotincluded,dataistransferredatthebest-effortratethatdoesnotdelayothertransferswhichwererequestedalongwithanX-Transfer-Rateheader.
–Atransferrateof0isvalidandindicatesabest-efforttransferofdata.
NoteTheX-Transfer-RaterequestheaderisaCOSextension.
X-Transfer-Delay:–Thisheaderspecifiesasigneddelayinmilliseconds.
–Ifthedelayispositive,COSwaitsforthetimeintervalspecifiedbeforestartingthetransferofobjectdataattherequestedtransferrate.
Thepositivedelaycanhaveamaximumvalueof30seconds.
–AnegativedelayindicatesthattheclientwantstouseanelasticitybufferandintendstotransmitdatafromthepartiallyfullbufferthatreceivesdatafromCOSattherequestedtransferrate.
Inthiscase,COSstartstransferringthedataassoonastheretrieverequestisreceived,andattemptstosenddataataratehigherthantherequestedrate.
COS,inessence,triestomatchtheamountofdatathatwouldhavebeensenttotheclientifthedatatransferhadbeeninitiated"delay"secondsbeforethereceiptoftherequest.
Thenegativedelaycanhavemaximummagnitudeoffourseconds.
NoteTheX-Transfer-DelayrequestheaderisaCOSextension.
Range:bytes=–Torequestthetransferofspecificportionsoftheobjectdata,inaccordancewiththespecificationsinsection14.
35ofRFC2616,includethisheader.
–Onlybyte-rangesaresupported.
–Multiplebyterangesaresupported.
4-6CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIRetrievinganObject–Iftherangedidnotincludetheentireobject,aresponsestatuscodeof206(PartialContent)isreturnedbyCOS.
–ThePartialContentresponsetoarequestformultiplenon-overlappingrangesofdatacontainsmultiplepartsinthemessagebody.
If-Match:ETag–TheobjectdataisretrievedonlyiftheclientspecifiedETagvaluematchestheETagofthecontent.
Else,412(PreconditionFailed)isreturned.
If-None-Match:ETag–304(NotModified)isreturnediftheclientspecifiedETagvaluematchestheETagofthecontent,indicatingtotheclientthattheobjectcachedbyithasnotbeenmodifiedsince.
If-Modified-Since:time–304(NotModified)isreturnediftheclientspecifiedtimeisequaltoorlaterthanthelastmodifiedtimeoftheobject.
If-Unmodified-Since:time–Theobjectdataisretrievedonlyiftheclientspecifiedtimeisequaltoorlaterthanthelastmodifiedtimeoftheobject.
Else,412(PreconditionFailed)isreturned.
ResponseStatusCodesAresponsestatuscodeof2xxindicatessuccessfulcompletionoftherequest.
ResponseHeadersTheresponsewillincludeoneofthefollowingheaders:LastModified—Atime-stampofwhentheobjectwascreatedormodified.
ETag—ThehexadecimalrepresentationoftheMD5hashoftheobjectdata.
Content-Type—Thecontenttypeassociatedwiththeobjectwhenitwascreated.
Content-Length—Thenumberofbytesintheobject.
X-Object-Goid—TheglobalobjectidentifierassignedbyCOSwhentheobjectwascreated.
NoteTheX-Object-GoidresponseheaderisaCOSextension.
X-Object-Meta-*—Customobjectattributesoftheobject.
X-Object-Is-Dynamic:yes—Theobjectbeingretrievedisbeingextended.
Thisoccurswhenyouretrieveobjectdatawhileobjectcreationisinprogress.
Sucharetrievalofthedataisusefulwhenalargeobjectisbeingcreatedandyouwanttoaccessthedatathathasbeenstored,evenasmoredataisbeingappendedtotheobject.
ThisresponseheaderisaCOSextension.
NoteTheX-Object-Is-DynamicresponseheaderisaCOSextension.
4-7CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPICreatingorUpdatingAnObjectCreatingorUpdatingAnObjectTocreateorupdateanobject,thatis,towriteoroverwriteanobject'scontentandmetadata,usethefollowingHTTPPUTrequest:PUT/v1///HTTP/1.
1RequiredRequestHeadersX-Auth-Token:NoteThisheadermaybeexcludedifthecontainerwriteACLpermitsanonymousaccess.
Content-Type–Ifthisheaderisnotincluded,thesystemwillattempttoguessthetypeofthecontentbasedontheobject'sname/metadata.
Ifthesystemisunsuccessful,theContent-Typeissettothedefaultapplication/octet-streamvalue.
Content-Length/Transfer-Encoding:chunked–EitheravalidContent-Lengthheader,statingthesizeoftheobject,oraTransfer-Encoding:chunkedheader,indicatingthatthedatalengthisencodedin-lineatthestartofeachchunkoftheobjectdatasentintherequest,mustbeincluded.
OptionalRequestHeadersETag–TherequestmayincludethisheaderwiththevaluesettothehexadecimalrepresentationoftheMD5hashoftheobjectdata.
–IftheETagvaluedoesnotmatchMD5hashcomputedbyCOS,a422(UnprocessableEntity)responsestatuscodeisreturned.
X-Object-Meta-:–Includethisheadertosetcustomattributesforanobject.
X-Follow-Redirect:true–Ifthisheaderisincluded,theCOSnodemayrespondwithastatuscodeof307(TemporaryRedirect)andincludeaLocationresponseheaderindicatingtheURLtowhichtheclientshouldaddresstherequest.
–Ifthisheaderisabsent,orthevalueoftheheaderisnottrue,theCOSnodereceivingtherequestwillperformthenecessaryoperation.
NoteTheX-Follow-RedirectrequestheaderisaCOSextension.
Expect:100-Continue–Itisrecommendedthatyouincludethisheaderintheinitialrequestandomitobjectcontentfromthebodyoftherequest.
4-8CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIDeletinganObject–ThereceivingCOSnodewillrespondwitheithera100(Continue)statuscode,a307(TemporaryRedirect)statuscode,oranerrorstatuscode.
–Ifthe100(Continue)statuscodeisreceived,repeattherequestalongwiththeobjectcontentinthebody.
ResponseStatusCodesTheresponsewillincludeoneofthefollowingheaders:2xx—IndicatesthesuccessfulcompletionoftheHTTPPUTrequest.
5xx—IndicatesfailureoftheHTTPPUTrequest.
ResponseHeadersTheresponsewillincludeoneofthefollowingheaders:LastModified—Atime-stampofwhentheobjectwascreatedorupdated.
ETag—AhexadecimalrepresentationoftheMD5hashoftheobjectdata.
DeletinganObjectTopermanentlyremoveanobject,usethefollowingHTTPDELETErequest:NoteTomakethisrequest,oneofthefollowingmustbetrue:YouareanaccountadminoraCOSreselleradmin.
Ifawrite-ACLhasbeenspecifiedforthecontainer,eitheryouareassignedarolelistedintheACL,ortherole*isincludedintheACL,permittinganonymousaccess.
DELETE/v1///HTTP/1.
1Deletinganobjectremovesboththeobjectdataandmetadata.
Anysubsequentoperationsattemptedontheobjectwillreturna404(NotFound)responsestatuscode.
4-9CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPICreatingorUpdatingContainerMetadataRequiredRequestHeaderNoteIfthecontainerwrite-ACLpermitsanonymousaccess,thisheaderisnotrequired.
X-Auth-Token:ResponseStatusCode204(NoContent)—Indicatestheobjecthasbeendeleted.
CreatingorUpdatingContainerMetadataTocreateorupdatecustomcontainerattributes,usethefollowingHTTPPOSTrequest:NoteTomakethisrequest,youmustbeanaccountadminoraCOSreselleradmin.
POST/v1//HTTP/1.
1TheattributesarespecifiedinHTTPheadersincludedintheHTTPPOSTrequest.
Iftheattributeexists,itsvaluewillbeoverwritten.
Else,anewattributeiscreated.
RequiredRequestHeaderX-Auth-Token:X-Container-Meta-:ResponseStatusCodeTheresponsestatuscodeisoneofthefollowing:204(NoContent)—ThePOSToperationsucceeded400(BadRequest)—ThePOSTrequestisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccountorcontainer5xx—InternalServerError4-10CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIRetrievingContainerMetadataRetrievingContainerMetadataToretrieveacontainer'smetadatatolearnitsstatus,usethefollowingHTTPHEADrequest:NoteTomakethisrequest,youmustbeanaccountadminoraCOSreselleradmin.
Or,ifaread-ACLhasbeenspecifiedforthecontainer,youmustbeassignedarolelistedintheACL.
Or,the'*'rolemustbeincludedintheACL,permittinganonymousaccess.
HEAD/v1//HTTP/1.
1Thisrequestcanbeusedagainstacontainertodeterminethenumberofobjects,andthetotalbytesizeofallobjectsstoredinthecontainer.
RequiredRequestHeaderNoteIfthecontainerread-ACLpermitsanonymousaccess,thisheaderisnotrequired.
X-Auth-Token:ResponseStatusCodeTheresponsestatuscodeisoneofthefollowing:2xx(Success)—TheHEADoperationsucceeded400(BadRequest)—ThePOSTrequestisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccountorcontainer5xx—InternalServerErrorResponseHeadersX-Container-Object-Count–Thevalueofthisheaderisthenumberofobjectsinthecontainer.
X-Container-Bytes-Used–Thevalueofthisheaderisthetotalbytesizeofalltheobjectsinthecontainer.
X-Container-Meta-:–Thisheaderreturnsthecustomattributesofthecontainer.
4-11CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIDeletingContainerMetadataDeletingContainerMetadataTodeletecustomcontainerattributes,usethefollowingHTTPPOSTrequest:NoteTomakethisrequest,youmustbeanaccountadminorareselleradmin.
POST/v1//HTTP/1.
1RequiredRequestHeadersX-Auth-Token:X-Container-Meta-–Anemptyheaderofthistypewithouttheattributevaluecanbeusedtodeletethecustomattributenamedintheheader.
X-Remove-Container-Meta-:–Alternatively,aheaderofthistypecanbeusedtodeletethecustomattributenamedintheheader.
–Thearbitraryattributevalueisignoredbythesystem.
ResponseStatusCodeTheresponsestatuscodeisoneofthefollowing:204(NoContent)—ThePOSToperationsucceeded400(BadRequest)—ThePOSTrequestisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccountorcontainer5XX—InternalServerErrorCreatingorUpdatingObjectMetadataTocreateorupdatecustomobjectattributes,usethefollowingHTTPPOSTrequest:NoteTomakethisrequest,youmustbeanaccountadminoraCOSreselleradmin.
Or,ifawrite-ACLhasbeenspecifiedforthecontainer,youmustbeassignedarolelistedintheACL.
Or,the'*'rolemustbeincludedintheACL,permittinganonymousaccess.
POST/v1///HTTP/1.
14-12CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIRetrievingObjectMetadataAssigningcustomattributestoobjectsenablesyoutobettercategorizetheobjects.
RequiredRequestHeaderX-Auth-Token:NoteIfthecontainerwrite-ACLpermitsanonymousaccess,thisheaderisnotrequired.
X-Object-Meta-:–Iftheattributeexists,itsvalueisupdatedtothatspecifiedintheheader.
Else,theattributeiscreated.
ResponseStatusCodeTheresponsestatuscodeisoneofthefollowing:204(NoContent)—ThePOSToperationsucceeded400(BadRequest)—ThePOSTrequestisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccountorcontainer5XX—InternalServerErrorRetrievingObjectMetadataToretrieveanobject'smetadata,includingitscustomattributes,usethefollowingHTTPHEADrequest:NoteTomakethisrequest,youmustbeanaccountadminoraCOSreselleradmin.
Or,ifaread-ACLhasbeenspecifiedforthecontainer,youmustbeassignedarolelistedintheACL,andtheReferrerheaderintherequestmustmatchtheACLreferrerpattern.
Or,the'*'rolemustbeincludedintheACL,permittinganonymousaccess.
HEAD/v1///HTTP/1.
RequiredRequestHeaderNoteIfthecontainerread-ACLpermitsanonymousaccess,thisheaderisnotrequired.
X-Auth-Token:ResponseStatusCodeTheresponsestatuscodeisoneofthefollowing:4-13CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIDeletingObjectMetadata2xx(Success)—TheHEADoperationsucceeded400(BadRequest)—TheHEADoperationisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccountorcontainer5xx—InternalServerErrorResponseHeadersLastModified—atime-stampofwhentheobjectwascreatedormodified.
ETag—thehexadecimalrepresentationoftheMD5hashoftheobjectdata.
Content-Type—thecontenttypeassociatedwiththeobjectwhenitwascreated.
Content-Length—thenumberofbytesintheobject.
X-Object-Meta-:—customobjectattributes,ifany.
DeletingObjectMetadataTodeletecustomobjectattributes,usethefollowingHTTPPOSTrequest:NoteTomakethisrequest,youmustbeanaccountadminoraCOSreselleradmin.
Or,ifawrite-ACLhasbeenspecifiedforthecontainer,youmustbeassignedarolelistedintheACL.
Or,the'*'rolemustbeincludedintheACL,permittinganonymousaccess.
POST/v1/HTTP/1.
1RequiredRequestHeadersX-Auth-Token:X-Object-Meta-:–Anemptyheaderofthistypewithouttheattributevaluecanbeusedtodeletethecustomattributenamedintheheader.
X-Remove-Object-Meta-:–Alternatively,aheaderofthistypecanbeusedtodeletethecustomattributenamedintheheader.
–Thearbitraryvalueisignoredbythesystem.
ResponseStatusCodeTheresponsestatuscodeisoneofthefollowing:204(NoContent)—ThePOSToperationsucceeded4-14CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPICreatingorUpdatingAccountMetadata400(BadRequest)—ThePOSToperationisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccountorcontainer5xx—InternalServerErrorCreatingorUpdatingAccountMetadataTocreateorupdatecustomaccountattributes,usethefollowingHTTPPOSTrequest:NoteToperformthisoperation,youmustbeanaccountadministratororaCOSreselleradmin.
POST/v1/HTTP/1.
1RequiredRequestHeadersX-Auth-Token:X-Account-Meta-:–Iftheattributeexists,itsvalueisupdatedtothatspecifiedintheheader.
Else,theattributeiscreated.
ResponseStatusCodeTheresponsestatuscodeisoneofthefollowing:204(NoContent)—ThePOSToperationsucceeded400(BadRequest)—ThePOSToperationisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccount5xx—InternalServerErrorRetrievingAccountMetadataToretrieveaccountmetadatatochecktheaccountstatistics,usethefollowingHTTPHEADrequest:NoteToperformtheoperation,youmustbeanaccountadministratororaCOSreselleradmin.
HEAD/v1/HTTP/1.
14-15CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIDeletingAccountMetadataRequiredRequestHeadersX-Auth-Token:ResponseStatusCodesTheresponsestatuscodeisoneofthefollowing:2xx(Success)—TheHEADoperationsucceeded400(BadRequest)—TheHEADoperationisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccount5xx—InternalServerErrorResponseHeadersX-Account-Container-Count:–Thevalueoftheheaderisthenumberofcontainersintheaccount.
X-Account-Object-Count:–Thevalueoftheheaderisthenumberofobjectsintheaccount.
X-Account-Bytes-Used:–ThevalueoftheheaderisthetotalnumberofbytesinCOSforthespecifiedaccount.
X-Account-Meta-:–Theheaderreturnscustomaccountattributesandtheirvalues.
DeletingAccountMetadataTodeletecustomaccountattributes,usethefollowingHTTPPOSTrequest:NoteToperformtheoperation,youmustbeanaccountadministratororaCOSreselleradmin.
POST/v1/HTTP/1.
1RequiredRequestHeadersX-Auth-Token:X-Account-Meta-:–Anemptyheaderofthistypewithouttheattributevaluecanbeusedtodeletethecustomattributenamedintheheader.
X-Remove-Account-Meta-:–Alternatively,aheaderofthistypecanbeusedtodeletethecustomattributenamedintheheader.
4-16CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIAccessControlLists(ACLs)–Thearbitraryvalueisignoredbythesystem.
ResponseStatusCodeTheresponsestatuscodeisoneofthefollowing:204(NoContent)—ThePOSToperationsucceeded400(BadRequest)—ThePOSToperationisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccount5xx—InternalServerErrorAccessControlLists(ACLs)Bydefault,toaccessastorageobject,arequestermustbeanaccountadministratoroftheaccountcontainingtheobject.
Anadministratorcanmodifytheaccesspolicyforacontaineranditsstorageobjectsbyusingcontaineraccesscontrollists(ACLs).
Theadministratorcanspecifythereadandwriteaccesscontrollistsaspartofthecontainermetadata.
WhenanACLisdeleted,thedefaultaccesspolicyisrestored.
AnACLhasthefollowingform:[item[,item.
.
.
]]AnACLitemcanbeoneofthefollowing:–Alltheusersofspecifiedaccountaregrantedaccesstoobjectsinthecontainer.
:–Usersidentifiedbythecombinationofthespecifiedaccountandusernamesaregrantedaccesstoobjectsinthecontainer.
*–Anasteriskpermitsanonymousaccess.
ThisoptionisaCOSextension.
CreatingorUpdatingACLsTocreateorupdateanACL,usethefollowingHTTPPOSTrequest:NoteToperformtheoperation,youmustbeanaccountadministratororaCOSreselleradmin.
POST/v1//HTTP/1.
14-17CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIDeletingACLsRequiredRequestHeadersX-Auth-Token:X-Container-Read:–SpecifythereadACLasthevalueofthisheader.
X-Container-Write:–SpecifythewriteACLasthevalueofthisheader.
ResponseStatusCodeTheresponsestatuscodeisoneofthefollowing:204(NoContent)—ThePOSToperationsucceeded400(BadRequest)—ThePOSTrequestisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccountorcontainer5xx—InternalServerErrorDeletingACLsTodeleteanACL,usethefollowingHTTPPOSTrequest:NoteToperformtheoperation,youmustbeanaccountadministratororaCOSreselleradmin.
POST/v1//HTTP/1.
1RequiredRequestHeadersX-Auth-Token:X-Container-Read:–SpecifyanemptylistasthevalueofthisheadertodeletethereadACL.
X-Remove-Container-Read:–Alternatively,aheaderofthistypecanbeusedtodeletethereadACL.
–Thearbitraryvalueisignoredbythesystem.
X-Container-Write:–SpecifyanemptylistasthevalueofthisheadertodeletethewriteACL.
X-Remove-Container-Write:–Alternatively,aheaderofthistypecanbeusedtodeletethewriteACL.
–Thearbitraryvalueisignoredbythesystem.
4-18CiscoCloudObjectStorageRelease2.
1.
1APIGuideChapter4SwiftAPIDeletingACLsResponseStatusCodeTheresponsestatuscodeisoneofthefollowing:204(NoContent)—ThePOSToperationsucceeded400(BadRequest)—ThePOSTrequestisnotvalid401(Unauthorized)—Theusertokenismissingorinvalid403(Forbidden)—Theuserdoesnothavepermissiontomodifythecontainerattributes404(NotFound)—ThestorageURLreferencesanon-existentaccountorcontainer5xx—InternalServerError
UCloud优刻得近日针对全球大促活动进行了一次改版,这次改版更加优惠了,要比之前的优惠价格还要低一些,并且新增了1核心1G内存的快杰云服务器,2元/首年,47元/年,这个价格应该是目前市面上最低最便宜的云服务器产品了,有需要国内外便宜VPS云服务器的朋友可以关注一下。UCloud好不好,UCloud服务器怎么样?UCloud服务器值不值得购买UCloud是优刻得科技股份有限公司旗下拥有的云计算服...
HostKvm是一家成立于2013年的国外主机服务商,主要提供基于KVM架构的VPS主机,可选数据中心包括日本、新加坡、韩国、美国、中国香港等多个地区机房,均为国内直连或优化线路,延迟较低,适合建站或者远程办公等。目前商家发布了夏季特别促销活动,针对香港国际/韩国机房VPS主机提供7折优惠码,其他机房全场8折,优惠后2GB内存套餐月付5.95美元起。下面分别列出几款主机套餐配置信息。套餐:韩国KR...
pigyun怎么样?PIGYunData成立于2019年,2021是PIGYun为用户提供稳定服务的第三年,目前商家提供香港CN2线路、韩国cn2线路、美西CUVIP-9929、GIA等线路优质VPS,基于KVM虚拟架构,商家采用魔方云平台,所有的配置都可以弹性选择,目前商家推出了七月优惠,韩国和美国所有线路都有相应的促销,六折至八折,性价比不错。点击进入:PIGYun官方网站地址PIGYUN优惠...
internalservererror为你推荐
支持ipadcisco2960思科2960如何划分vlan?ipad代理在哪买ipad更便宜piaonimai跪求朴妮唛的的韩文歌,不知道是哪一部的,第一首放的是Girl's Day《Oh! My God》。求第三首韩文歌曲,一男一女唱的。网络u盘你们谁知道网络硬盘怎么用美国独立美国独立时不是只有13个洲吗?后来的领土都是怎么得来的。地址栏图标网站在地址栏显示的图标,是怎么显示出来的本帖隐藏的内容本帖隐藏的内容需要回复才可以浏览 是怎么弄的 我像弄1个 178的帖joomla安装下载app并安装引擎收录目前搜索引擎收录需要付费的有哪些?免费的有哪些?
高防服务器租用qy 域名交易网 新加坡主机 新加坡服务器 宕机监控 免费全能空间 qq数据库下载 vip购优惠 重庆双线服务器托管 免费私人服务器 国外视频网站有哪些 raid10 四川电信商城 韩国代理ip 独立主机 php服务器 摩尔庄园注册 tracker服务器 cpu使用率过高怎么办 服务器是什么意思 更多