Získání podporovaných zdrojů úložiště

Metoda získat podporované zdroje úložiště vrátí seznam zdrojů a možností úložiště podporovaných službou překladu dokumentů.

Adresa URL požadavku

Odeslat GET požadavek na:

GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0/storagesources

Přečtěte si, jak najít vlastní název domény.

Důležité

  • Všechny požadavky rozhraní API na službu překladu dokumentů vyžadují vlastní koncový bod domény.
  • Koncový bod, který se nachází na vašich Azure Portal klíčů prostředků a koncových bodech globálního překladatele, nemůžete použít api.cognitive.microsofttranslator.com k převedení požadavků HTTP na překlad dokumentů.

Hlavičky požadavku

Hlavičky požadavku jsou:

Hlavičky Description
Ocp-Apim-Subscription-Key Požadovaná hlavička žádosti

Stavové kódy odpovědí

Níže jsou uvedené možné stavové kódy HTTP, které požadavek vrátí.

Stavový kód Description
200 OK. Úspěšná žádost a vrátí seznam zdrojů úložiště.
500 Došlo k vnitřní chybě serveru.
Další stavové kódy
  • Příliš mnoho žádostí
  • Server je dočasně nedostupný.

Získat podporovanou odpověď zdrojů úložiště

Úspěšná podpora získání zdrojů úložiště

Základní typ pro návrat do seznamu v rozhraní API zdroje úložiště s podporou Get

Název Typ Description
hodnota řetězec [] Seznam objektů.

Chybová odezva

Název Typ Description
kód řetězec Výčty obsahující chybové kódy vysoké úrovně. Možné hodnoty:
  • InternalServerError
  • InvalidArgument
  • InvalidRequest
  • RequestRateTooHigh
  • ResourceNotFound
  • ServiceUnavailable
  • Neautorizováno
zpráva řetězec Získá chybovou zprávu vysoké úrovně.
innerError InnerTranslationError Nový formát vnitřní chyby, který odpovídá pokynům Cognitive Services API. Obsahuje povinné vlastnosti ErrorCode, zpráva a volitelné vlastnosti target, Details (dvojice klíč-hodnota), vnitřní chyba (může být vnořený).
innerError. Code řetězec Načte řetězec chyby kódu.
innerError. Message řetězec Získá chybovou zprávu vysoké úrovně.
innerError. Target řetězec Získá zdroj chyby. Může to být například "dokumenty" nebo "ID dokumentu" v případě neplatného dokumentu.

Příklady

Příklad úspěšné odpovědi

Následuje příklad úspěšné odpovědi.

{
  "value": [
    "AzureBlob"
  ]
}

Příklad chybové odpovědi

Následuje příklad chybové odpovědi. Schéma pro ostatní kódy chyb je stejné.

Stavový kód: 500

{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}

Další kroky

Pokud chcete získat další informace o použití překladu dokumentů a klientské knihovny, postupujte podle našeho rychlého startu.