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
hostkvm怎么样?hostkvm是一家国内老牌主机商家,商家主要销售KVM架构的VPS,目前有美国、日本、韩国、中国香港等地的服务,站长目前还持有他家香港CN2线路的套餐,已经用了一年多了,除了前段时间香港被整段攻击以外,一直非常稳定,是做站的不二选择,目前商家针对香港云地和韩国机房的套餐进行7折优惠,其他套餐为8折,商家支持paypal和支付宝付款。点击进入:hostkvm官方网站地址hos...
青云互联怎么样?青云互联是一家成立于2020年的主机服务商,致力于为用户提供高性价比稳定快速的主机托管服务,目前提供有美国免费主机、香港主机、韩国服务器、香港服务器、美国云服务器,香港安畅cn2弹性云限时首月五折,15元/月起;可选Windows/可自定义配置,让您的网站高速、稳定运行。点击进入:青云互联官方网站地址青云互联优惠码:八折优惠码:ltY8sHMh (续费同价)青云互联香港云服务器活动...
今天获得消息,vdsina上了AMD EPYC系列的VDS,性价比比较高,站长弄了一个,盲猜CPU是AMD EPYC 7B12(经过咨询,详细CPU型号是“EPYC 7742”)。vdsina,俄罗斯公司,2014年开始运作至今,在售卖多类型VPS和独立服务器,可供选择的有俄罗斯莫斯科datapro和荷兰Serverius数据中心。付款比较麻烦:信用卡、webmoney、比特币,不支持PayPal...
internalservererror为你推荐
连接ios操作http开启javascript怎样手动开启Javascript温州商标注册温州代理注册个商标是怎么收费的?qq头像上传失败我怎么总是QQ上传头像失败,独立访客百度统计中访客数(UV)什么意思metinfometinfo是免费的吗?可以永久免费使用吗?谷歌新漏洞google hacking 技术有哪些权限777-rwx-rwx-rwx- linux权限数字是多少 不是777discuzx2.5discuzX 2.5网站搬家与域名更换一起怎么操作?
最好的虚拟主机 韩国vps google电话 directadmin mysql主机 丹弗 坐公交投2700元 速度云 100m独享 香港新世界中心 多线空间 域名与空间 shuang12 韩国代理ip 英雄联盟台服官网 独立主机 畅行云 lamp的音标 购买空间 贵州电信 更多