Diagnose and troubleshoot bad request exceptions in Azure Cosmos DB
APPLIES TO: NoSQL
The HTTP status code 400 represents the request contains invalid data or it's missing required parameters.
Missing the ID property
On this scenario, it's common to see the error:
The input content is invalid because the required properties - 'id; ' - are missing
A response with this error means the JSON document that is being sent to the service is lacking the required ID property.
Solution
Specify an id
property with a string value as per the REST specification as part of your document, the SDKs do not autogenerate values for this property.
Invalid partition key type
On this scenario, it's common to see errors like:
Partition key ... is invalid.
A response with this error means the partition key value is of an invalid type.
Solution
The value of the partition key should be a string or a number, make sure the value is of the expected types.
Wrong partition key value
On this scenario, it's common to see these errors:
Response status code does not indicate success: BadRequest (400); Substatus: 1001
PartitionKey extracted from document doesn’t match the one specified in the header
A response with this error means you are executing an operation and passing a partition key value that does not match the document's body value for the expected property. If the collection's partition key path is /myPartitionKey
, the document has a property called myPartitionKey
with a value that does not match what was provided as partition key value when calling the SDK method.
Solution
Send the partition key value parameter that matches the document property value.
Next steps
- Diagnose and troubleshoot issues when you use the Azure Cosmos DB .NET SDK.
- Learn about performance guidelines for .NET v3 and .NET v2.
- Diagnose and troubleshoot issues when you use the Azure Cosmos DB Java v4 SDK.
- Learn about performance guidelines for Java v4 SDK.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for