st replace
[This document supports a preliminary release of a software product that may be changed substantially prior to final commercial release. This document is provided for informational purposes only.]
Replaces (updates) an existing entity. The entire entity is replaced (no partial updates).
st replace <authorityid> <containerid> <entityid> [<payload-file> | ?]
<credentials>
[/REST | /SOAP]
[/parallel:<number>] [/verbose]
The command replaces entities only. It cannot be used to update authorities and containers.
Examples
Examples of the replace command are given below.
Example 1 Replacing an entity
The following example updates existing entity (e1). The command specifies '?' instead of specifying a file name. Therefore, Notepad opens showing the existing entity. You update the user properties, save and close Notepad. The updated XML is used to replace the existing entity e1.
cmdPrompt>st replace myauth c1 e1 ? /host:data.database.windows.net /user:userName
You can also specify file name containing the replacement entity.
cmdPrompt>st replace myauth c1 e1 MyReplacementEntity.xml /host:data.database.windows.net /user:userName
Note that you cannot update metadata properties (Id, Version and Kind). You can only add or update user-defined properties.
Example 2 Replacing a blob entity
When replacing a blob entity, file name, containing the replacement blob, is required.