Put object tagging
Sets the tag set of the object
Function PutObjectTagging(Val Name, Val Bucket, Val BasicData, Val Tags, Val Headers = Undefined, Val Directory = False) Export
Parameter | CLI option | Type | Required | Description |
---|---|---|---|---|
Name | --name | String | ✔ | Object name |
Bucket | --bucket | String | ✔ | Bucket name |
BasicData | --basic | Structure Of KeyAndValue | ✔ | Basic request data. See GetBasicDataStructure |
Tags | --tagset | Structure Of KeyAndValue | ✔ | Set of tags (key and value) |
Headers | --headers | Map Of KeyAndValue | ✖ | Additional request headers, if necessary |
Directory | --dir | Boolean | ✖ | True > Path style URL, False > Virtual hosted style URL |
Returns: Structure Of KeyAndValue - serialized JSON response from storage
tip
Setting up a new set removes all existing object tags
Method at AWS documentation: PutObjectTagging
1C:Enterprise/OneScript code example
URL = "storage-155.s3hoster.by";
AccessKey = "BRN5RKJE67...";
SecretKey = "NNhv+i9PrytpT8Tu0C1N...";
Region = "BTC";
BasicData = OPI_S3.GetBasicDataStructure(URL, AccessKey, SecretKey, Region);
Name = "picture.jpg";
Directory = True; // Formation URL in path-style
Bucket = "opi-dirbucket3";
TagStructure = New Structure;
TagStructure.Insert("MyTag1", "SomeValue");
TagStructure.Insert("MyTag2", "AnotherOne");
Result = OPI_S3.PutObjectTagging(Name, Bucket, BasicData, TagStructure, , Directory);
- Bash
- CMD/Bat
oint s3 PutObjectTagging \
--name "picture.jpg" \
--bucket "opi-dirbucket3" \
--basic "{'URL':'storage-155.s3hoster.by','AccessKey':'***','SecretKey':'***','Region':'BTC','Service':'s3'}" \
--tagset "{'MyTag1':'SomeValue','MyTag2':'AnotherOne'}" \
--dir true
oint s3 PutObjectTagging ^
--name "picture.jpg" ^
--bucket "opi-dirbucket3" ^
--basic "{'URL':'storage-155.s3hoster.by','AccessKey':'***','SecretKey':'***','Region':'BTC','Service':'s3'}" ^
--tagset "{'MyTag1':'SomeValue','MyTag2':'AnotherOne'}" ^
--dir true
Result
{
"status": 200,
"response": {},
"headers": {
"Accept-Ranges": "bytes",
"Date": "Mon, 15 Sep 2025 23:17:10 GMT",
"Server": "MinIO",
"Strict-Transport-Security": "max-age=31536000; includeSubDomains",
"Vary": "Origin, Accept-Encoding",
"X-Amz-Id-2": "0757065d17b69556603743b9ea63f04bc7b9f349245bbff6b0ba901258e9c169",
"X-Amz-Request-Id": "186597E22B186515",
"X-Content-Type-Options": "nosniff",
"X-XSS-Protection": "1; mode=block",
"Content-Length": "0",
"Content-Type": "text/plain; charset=utf-8"
}
}