Merge pull request #218 from SRE-PRG/skip-doc

--skip-if-same documentation update

Commands.md

@@ -60,7 +60,7 @@ Print token in JSON Web Token (JWT) format.
 |**`getblob`**|`--blob`|`--file`|`--if-newer`, `--delete-after-copy`|
 |**`getblobs`**|`--container`|`--directory`|`--prefix`, `--if-newer`, `--delete-after-copy`, `--exclude`, `--absolute-paths`|
 |**`setblob`**|`--file`|`--blob` |`--force`|
-|**`setblobs`**|`--directory`|`--container`|`--force`,`--exclude`|
+|**`setblobs`**|`--directory`|`--container`|`--force`,`--exclude`, `--skip-if-same`|
 
 All commands support arguments `--identity` and `--verbose`.
 
@@ -103,6 +103,9 @@ Bool. Deletes blob after successful copy. Similar to "move" operations on file s
 *`--absolute-paths`*
 Bool. Listing of blobs is formatted to absolute URIs path. E.g. `https://{blobStorage-name}.blob.core.windows.net/{container-name}/file841.blob` 
 
+*`--skip-if-same`*
+Bool. Skip setting particular blob in batch if local file and already existing remote blob are same. Try to upload otherwise.
+
 ## Known limitations
 
 Commands `listblobs` and `getblobs` return up to 5,000 blobs filtered on Azure API side by argument `--prefix`.

Examples.md

@@ -66,6 +66,9 @@ azmi setblobs -d $UPLOAD_DIR -c $CONTAINER --identity $identity
 # upload and overwrite existing blobs
 azmi setblobs -d $UPLOAD_DIR -c $CONTAINER --force
 
+# the same, but before overwriting verify contents via hashes; upload only if contents are different
+azmi setblobs -d $UPLOAD_DIR -c $CONTAINER --force --skip-if-same
+
 # setblobs and getblobs have the same folder structure
 azmi getblobs -c $CONTAINER -d $DOWNLOAD_DIR
 diff -r $UPLOAD_DIR $DOWNLOAD_DIR # returns exit code 0