Azure CosmosDB: illegal characters in Document Id

Question

I have the issue that the Ids that are being generated based on certain input contain the character "/". This leads to an error during the Upsert operation as "/" is not allowed in the Document id.

Which characters are not allowed beside that? What are ways to handle such a situation?

Answer 1

The illegal characters are /, \\, ?, # (see https://learn.microsoft.com/en-us/dotnet/api/microsoft.azure.documents.resource.id?view=azure-dotnet)

Ways to deal with such a situation:

• Remove the character already in the input used for generating the id
• Replace the character in the id with another character / set of characters
• Use Hashing / Encoding (e.g. Base64)

If you know a better way please share. Thanks