Show how to use the (autorest) x-ms-paths extension to overload operations for the same path.

overloads-in-swagger-2.0.json

{
    "swagger": "2.0",
    "info": {
        "title": "Show x-ms-paths",
        "version": "1.0"
    },
    "x-ms-paths": {
        /* Note - fake query parameter to make the path unique. Not actually used in the API. 
           You can also differentiate using a different path parameter name if the path is parameterized 
        */
        "/pets/{name}?dog": { 
            "put": {
                "parameters": [
                    {
                        "name": "dog",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "/definitions/Dog"
                        }
                    },
                    {
                        "name": "name",
                        "in": "path",
                        "required": true,
                        "type": "string"
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Created a Dog",
                        "schema": {
                            "$ref": "/definitions/Dog"
                        }
                    }
                }
            }
        },
        "/pets/{name}?cat": {
            "put": {
                "parameters": [
                    {
                        "name": "cat",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "/definitions/Cat"
                        }
                    },
                    {
                        "name": "name",
                        "in": "path",
                        "required": true,
                        "type": "string"
                    }
                ],
                "responses": {
                    "201": {
                        "description": "Created a Cat",
                        "schema": {
                            "$ref": "/definitions/Cat"
                        }
                    }
                }
            }
        }
    },
    "definitions": {
        "Dog": {
            "type": "object",
            "properties": {
                "bark": {
                    "type": "string"
                }
            }
        },
        "Cat": {
            "type": "object",
            "properties": {
                "meow": {
                    "type": "string"
                }
            }
        }
    }
}