サポートされるストレージ ソースの取得

サポートされるストレージ ソースの取得メソッドでは、ドキュメント翻訳サービスでサポートされているストレージ ソースおよびオプションの一覧が返されます。

要求 URL

GET 要求の送信先は次のとおりです。

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

カスタム ドメイン名を見つける方法について説明します。

重要

  • ドキュメント翻訳サービスへのすべての API 要求には、カスタム ドメイン エンドポイントが必要です
  • ドキュメント翻訳への HTTP 要求を行うために、Azure portal リソースの [キーとエンドポイント] ページで見つかるエンドポイントも、グローバル Translator エンドポイント api.cognitive.microsofttranslator.com も使用することはできません。

要求ヘッダー

要求ヘッダーを次に示します。

ヘッダー 説明
Ocp-Apim-Subscription-Key 必要な要求ヘッダー

応答状態コード

要求によって返される可能性のある HTTP 状態コードを次に示します。

状態コード 説明
200 OK です。 要求が成功して、ストレージ ソースの一覧を返します。
500 内部サーバー エラー。
その他の状態コード
  • 要求が多すぎます
  • サーバーが一時的に使用できません。

サポートされるストレージ ソースの取得の応答

サポートされるストレージ ソースの取得の成功した応答

一覧の基本データ型が、サポートされるストレージ ソースの取得 API で返されます。

名前 Type 説明
value string [] オブジェクトの一覧です。

エラー応答

名前 Type 説明
code string 高レベルのエラー コードを含む列挙型。 指定できる値
  • InternalServerError
  • InvalidArgument
  • InvalidRequest
  • RequestRateTooHigh
  • ResourceNotFound
  • ServiceUnavailable
  • 権限がありません
message string 高レベルのエラー メッセージを取得します。
innerError InnerTranslationError Cognitive Services API のガイドラインに準拠した新しい内部エラー形式。 必須プロパティとして ErrorCode、message、省略可能プロパティとして target、details (キーと値のペア)、inner error (入れ子が可能) が含まれています。
innerError.code string コード エラー文字列を取得します。
innerError.message string 高レベルのエラー メッセージを取得します。
innerError.target string エラーのソースを取得します。 たとえば、無効なドキュメントの場合は "documents" または "document id" になります。

成功した応答の例

以下は成功時の応答の例です。

{
  "value": [
    "AzureBlob"
  ]
}

エラー応答の例

以下は、エラー応答の例です。 他のエラー コードのスキーマも同じです。

状態コード: 500

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

次のステップ

クイックスタートに従って、ドキュメント翻訳とクライアント ライブラリの使用について学習します。