주요 콘텐츠로 건너뛰기

이 브라우저는 더 이상 지원되지 않습니다.

최신 기능, 보안 업데이트, 기술 지원을 이용하려면 Microsoft Edge로 업그레이드하세요.

Microsoft Edge 다운로드 Internet Explorer 및 Microsoft Edge에 대한 추가 정보
microsoft-foundry.rest.security.o-auth2-auth

Connections

Get a connection

GET /connections/{name}

Retrieves the specified connection and its configuration details without including credential values.

쿼리 매개 변수

api-version string 필수

The API version to use for this operation.

경로 매개 변수

name string 필수

The friendly name of the connection, provided by the user.

헤더 매개 변수

x-ms-client-request-id string

An opaque, globally-unique, client-generated string identifier for the request.

응답

The request has succeeded.

헤더

x-ms-client-request-id string

An opaque, globally-unique, client-generated string identifier for the request.

본문

Content-Type: application/json
name string 필수

The friendly name of the connection, provided by the user.

id string 필수

A unique identifier for the connection, generated by the service

type string | enum 필수

The Type (or category) of the connection

다음 중 하나:
string
enum
AzureOpenAIAzureBlobAzureStorageAccountCognitiveSearchCosmosDBApiKeyAppConfigAppInsightsCustomKeysRemoteTool_PreviewOpenAPIRemoteA2A
target string 필수

The connection URL to be used for this service

isDefault boolean 필수

Whether the connection is tagged as the default connection of its type

credentials ApiKey | AAD | CustomKeys | SAS | None | AgenticIdentityToken_Preview 필수

A base class for connection credentials

(다음 버전 중 하나)
ApiKey ApiKeyCredentials

API Key Credential definition

type enum 필수

The credential type

ApiKey
key string

API Key

AAD EntraIDCredentials

Entra ID credential definition

type enum 필수

The credential type

AAD
CustomKeys CustomCredential

Custom credential definition

type enum 필수

The credential type

CustomKeys
SAS SASCredentials

Shared Access Signature (SAS) credential definition

type enum 필수

The credential type

SAS
SAS string

SAS token

None NoAuthenticationCredentials

Credentials that do not require authentication

type enum 필수

The credential type

None
AgenticIdentityToken_Preview AgenticIdentityPreviewCredentials

Agentic identity credential definition

type enum 필수

The credential type

AgenticIdentityToken_Preview
metadata object 필수

Metadata of the connection

[key: string] string

Client error

헤더

x-ms-error-code string

String error code indicating what went wrong.

본문

Content-Type: application/json
error Azure.Core.Foundations.Error 필수

The error object.

code string 필수

One of a server-defined set of error codes.

message string 필수

A human-readable representation of the error.

target string

The target of the error.

details Azure.Core.Foundations.Error[]

An array of details about specific errors that led to this reported error.

innererror Azure.Core.Foundations.InnerError

An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.

code string

One of a server-defined set of error codes.

innererror Azure.Core.Foundations.InnerError

Server error

헤더

x-ms-error-code string

String error code indicating what went wrong.

본문

Content-Type: application/json
error Azure.Core.Foundations.Error 필수

The error object.

code string 필수

One of a server-defined set of error codes.

message string 필수

A human-readable representation of the error.

target string

The target of the error.

details Azure.Core.Foundations.Error[]

An array of details about specific errors that led to this reported error.

innererror Azure.Core.Foundations.InnerError

An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.

code string

One of a server-defined set of error codes.

innererror Azure.Core.Foundations.InnerError

요청

GET /connections/{name} HTTP/1.1

응답

Status: 200
Content-Type: application/json
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json
ko-kr
사용자의 개인 정보 보호 선택
  • AI 고지 사항
  • 이전 버전
  • 블로그
  • 참가
  • 개인 정보 보호
  • 소비자 건강 개인 정보
  • 사용 조건
  • 상표
  • © Microsoft 2026