Prefix access keys

Префикстік кілттер (prefix access keys) белгілі бір жол бойынша қол жеткізуі шектелген пайдаланушыларды жасауға мүмкіндік береді. Бұл пайдаланушылар өз префиксі жұмыс істейтін бакеттерге байланыстырылған. Префикстік кілттермен жұмыс істегенде келесі шектеулер бар:

• пайдаланушы тек 1 бакетке ғана байланыстырылуы мүмкін (жасау кезінде);
• пайдаланушы басқа бакеттерге және өз бакетінің мазмұнына (егер жол осы пайдаланушының префиксінен басталмаса) қол жеткізе алмайды;
• қол жеткізу кілттерін тек жасау кезінде ғана алуға болады;
• пайдаланушыда тек 1 жұп кілт болуы мүмкін;
• пайдалануды жеңілдету үшін пайдаланушыларды олардың қол жеткізетін префиксімен байланыстырып атау ұсынылады. Мысалы username = user/folder1/file1; prefix = folder1/file1.

PAK қолдайтын әдістер

• CreatePrefixKey;
• ListPrefixKeys;
• DeletePrefixKey.

Сипаттама

exampleprefix жолы бойынша қол жеткізу үшін префикстік кілттері бар examplename пайдаланушысын жасау. Мұндай пайдаланушыда префикстік кілттердің тек бір жұбы ғана болуы мүмкін

Сұрау

 
PUT /?pak&username=examplename&prefix=exampleprefix HTTP/1.1Host: bucketName.hb.ru-msk.vkcloud-storage.ruDate: Wed, 14 Feb 2018 11:21:57 GMTAuthorization: authorization stringConnection: close

Сұрау параметрлері

• username — кілттер тиесілі болатын пайдаланушы;
• prefix — осы кілттер арқылы қолжетімді болатын жол префиксі.

Жауап

 
HTTP/1.1 200 OKServer: nginx/1.12.1Date: Wed, 14 Feb 2018 13:38:54 GMTContent-Type: application/xmlContent-Length: 351Connection: closeX-req-id: 2NrqrYuki<?xml version="1.0" encoding="utf-8"?><CreatePrefixKeyResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">    <BucketName>bucketName</BucketName>    <Prefix>exampleprefix</Prefix>    <UserName>examplename</UserName>    <SecretKey>LVQaicnPLR7eVg5soGgWCJjGe3w3S8toaRxd329xv4w</SecretKey>    <AccessKey>6hGka6NefpEoNse4xJOEx3</AccessKey></CreatePrefixKeyResult>

XML элементтерінің сипаттамасы

• BucketName — бакет атауы.
• Prefix — осы кілттер арқылы қолжетімді болатын жол префиксі.
• UserName — кілттер тиесілі болатын пайдаланушы.
• SecretKey — құпия кілт, тек жасау кезінде ғана қайтарылады, кейін кілтті алу мүмкін емес.
• AccessKey — жария кілт.

Сұраулар

 
GET /?pak&marker=prefix&max-keys=2&name-prefix=prefix HTTP/1.1Authorization: authorization stringConnection: closeDate: Wed, 14 Feb 2018 12:28:10 GMTHost: bucketName.hb.ru-msk.vkcloud-storage.ru

Сұрау параметрлері

• max-keys — листингтегі элементтердің ең көп саны optional.
• name-prefix — пайдаланушы аттары бойынша префикс optional.
• marker — листинг басталатын пайдаланушы аты немесе оның бір бөлігі optional.

Жауап

 
HTTP/1.1 200 OKServer: nginx/1.12.1Date: Wed, 14 Feb 2018 13:39:27 GMTContent-Type: application/xmlContent-Length: 457Connection: closeX-req-id: 35RBZWzAX<?xml version="1.0" encoding="utf-8"?><ListPrefixKeysResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">    <BucketName>bucketName</BucketName>    <IsTruncated>false</IsTruncated>    <NamePrefix>prefix</NamePrefix>    <MaxKeys>2</MaxKeys>    <Marker>prefix</Marker>    <Contents>          <UserName>prefixusers/prefix/for1</UserName>          <Prefix>prefix/for1</Prefix>    </Contents>    <Contents>          <UserName>prefixusers/prefix/for2</UserName>          <Prefix>prefix/for2</Prefix>     </Contents></ListPrefixKeysResult>

XML элементтерінің сипаттамасы

• BucketName — бакет атауы.
• IsTruncated — true, егер префикстік пайдаланушылардың тек бір бөлігі ғана шығарылса.
• Marker — листинг басталатын пайдаланушы аты немесе оның бір бөлігі.
• NamePrefix — пайдаланушы аттары бойынша префикс.
• MaxKeys — листингтегі элементтердің ең көп саны.
• Contents — пайдаланушыны қамтитын блок.
• UserName — пайдаланушы аты.
• Prefix — осы пайдаланушы үшін деректер қолжетімді болатын префикс.

Сұрау

 
DELETE /?pak&prefix=prefix/for1&username=prefixusers/prefix/for1 HTTP/1.1Authorization: authorization stringConnection: closeDate: Wed, 14 Feb 2018 13:05:31 GMTHost:  bucketName.hb.ru-msk.vkcloud-storage.ru

Сұрау параметрлері

• username — пайдаланушы аты.
• prefix — осы пайдаланушы үшін объектілер қолжетімді болатын жол optional.

Жауап

 
HTTP/1.1 200 OKServer: nginx/1.12.1Date: Wed, 14 Feb 2018 13:39:27 GMTContent-Type: application/xmlContent-Length: 207Connection: closeX-req-id: 33yVonNmQ<?xml version="1.0" encoding="utf-8"?><DeletePrefixKeyResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">     <UserName>prefixusers/prefix/for1</UserName>     <Prefix>prefix/for1</Prefix></DeletePrefixKeyResult>

XML элементтерінің сипаттамасы

• Prefix — осы кілттер арқылы қолжетімді болатын жол префиксі.
• UserName — кілттер тиесілі болатын пайдаланушы.