Azure-docs: Link to API Reference is invalid

[polarapfel]

http://docs.microsofttranslator.com/speech-translate.html does not open in any browser I tried.

The response page for that URL just prints:

Invalid URL
The requested URL "[no URL]", is invalid.
Reference #9.67ce33b8.1530858715.44247d34

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: d9a1e7ee-0ac1-8041-5924-97209ce90634
• Version Independent ID: 57c3fe42-7748-8318-92a5-c0b5f35cfe5f
• Content: Java Quickstart for Azure Cognitive Services, Microsoft Translator Speech API
• Content Source: articles/cognitive-services/translator-speech/quickstarts/java.md
• Service: cognitive-services
• GitHub Login: @v-jaswel
• Microsoft Alias: v-jaswel

[YutongTie-MSFT]

@polarapfel
Thanks for the feedback! We are currently investigating and will update you shortly.

[YutongTie-MSFT]

@polarapfel Thanks for the feedback! I have assigned the issue to the content author to investigate further and update the document as appropriate.

@v-jaswel Hi, 'API reference' is a broken link, can you please check it and update the document as necessary? Thanks a lot!

[polarapfel]

This link from the first paragraph also comes back with that same faulty response page: http://docs.microsofttranslator.com/text-translate.html#!/default/get_Speak

[polarapfel]

I did a quick search for what could cause that error.

It seems like this is caused by a faulty Akamai CDN setup. The published hostname in the Akamai configuration is not recognized by Akamai.

This is how it resolves for me.

EDIT (I confused the host name affected):

docs.microsofttranslator.com is an alias for docs.microsoft.com.
docs.microsoft.com is an alias for docs.microsoft.com.edgekey.net.
docs.microsoft.com.edgekey.net is an alias for e8858.g.akamaiedge.net.
e8858.g.akamaiedge.net has address 23.218.123.163

Whoever owns the Akamai configuration for docs.microsofttranslator.com needs to fix this ASAP please. This is not an isolated issue with just this documentation page. Can you please escalate this? Thanks!

[YutongTie-MSFT]

@polarapfel Thanks for the research, I will contact to the author directly.

[polarapfel]

@YutongTie-MSFT @v-jaswel I edited my above response.

This shows what's wrong here. Apparently, someone tried to move docs.microsofttranslator.com to docs.microsoft.com. What they did is CNAME docs.microsofttranslator.com to docs.microsoft.com which also already is a CNAME (with an existing Akamai CDN configuration).

Now, when resolving docs.microsofttranslator.com, the first CNAME level gets lost to Akamai and Akamai cannot map URLs from docs.microsofttranslator.com to a valid Akamai CDN mapping because it can map docs.microsoft.com only once.

Unfortunate (and unnecessary) mistake! Hope this gets fixed soon! Thanks!

[v-jaswel]

I've updated that API link in the Node.js Python, and C# quickstarts, and those PRs have merged. I've updated it in the Java quickstart as well, but I'm waiting on review of the PR.

[YutongTie-MSFT]

@v-jaswel Thanks for the update.

@polarapfel
We will now proceed to close this thread. If there are further questions regarding this matter, please reopen it and we will gladly continue the discussion.

[ValerieZoski]

https://httpstatuses.com/405
405 Method Not Allowed — httpstatuses.com
F

[ValerieZoski]

https://en.m.wikipedia.org/wiki/Interstate_405_(California)
Interstate 405 (California) - Wikipedia

[YutongTie-MSFT]

@ValerieZoski Hi, if you are suffering from similar issue or other new issue. Please go ahead to open a new ticket. The original post is too old. Thank you.