Microsoft.ApiManagement 서비스/작업 영역/api
Bicep 리소스 정의
다음을 대상으로 하는 작업으로 서비스/작업 영역/api 리소스 유형을 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.ApiManagement/service/workspaces/api 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.ApiManagement/service/workspaces/apis@2023-09-01-preview' = {
name: 'string'
parent: resourceSymbolicName
properties: {
apiRevision: 'string'
apiRevisionDescription: 'string'
apiType: 'string'
apiVersion: 'string'
apiVersionDescription: 'string'
apiVersionSet: {
description: 'string'
id: 'string'
name: 'string'
versionHeaderName: 'string'
versioningScheme: 'string'
versionQueryName: 'string'
}
apiVersionSetId: 'string'
authenticationSettings: {
oAuth2: {
authorizationServerId: 'string'
scope: 'string'
}
oAuth2AuthenticationSettings: [
{
authorizationServerId: 'string'
scope: 'string'
}
]
openid: {
bearerTokenSendingMethods: [
'string'
]
openidProviderId: 'string'
}
openidAuthenticationSettings: [
{
bearerTokenSendingMethods: [
'string'
]
openidProviderId: 'string'
}
]
}
contact: {
email: 'string'
name: 'string'
url: 'string'
}
description: 'string'
displayName: 'string'
format: 'string'
isCurrent: bool
license: {
name: 'string'
url: 'string'
}
path: 'string'
protocols: [
'string'
]
serviceUrl: 'string'
sourceApiId: 'string'
subscriptionKeyParameterNames: {
header: 'string'
query: 'string'
}
subscriptionRequired: bool
termsOfServiceUrl: 'string'
translateRequiredQueryParameters: 'string'
type: 'string'
value: 'string'
wsdlSelector: {
wsdlEndpointName: 'string'
wsdlServiceName: 'string'
}
}
}
속성 값
service/workspaces/api
이름 | 묘사 | 값 |
---|---|---|
이름 | 리소스 이름 Bicep자식 리소스의 이름과 형식을 설정하는 방법을 알아보세요. |
string(필수) |
부모 | Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 |
형식 리소스의 기호 이름: 작업 영역 |
속성 | 업데이트 속성의 API 엔터티 만들기 | ApiCreateOrUpdatePropertiesOrApiContractProperties |
ApiCreateOrUpdatePropertiesOrApiContractProperties
이름 | 묘사 | 값 |
---|---|---|
apiRevision | API의 수정 버전에 대해 설명합니다. 값이 제공되지 않으면 기본 수정 버전 1이 생성됩니다. | 문자열 제약 조건: 최소 길이 = 1 최대 길이 = 100 |
apiRevisionDescription | API 수정 버전에 대한 설명입니다. | 문자열 제약 조건: 최대 길이 = 256 |
apiType | 만들 API의 유형입니다. * http REST API를 만듭니다. * soap SOAP 통과 API를 만듭니다. * websocket websocket API를 만듭니다. * graphql GraphQL API를 만듭니다. 나중에 새 형식을 추가할 수 있습니다. |
'graphql' 'grpc' ' http ''odata' 'soap' 'websocket' |
apiVersion | API 버전이 지정된 경우 API의 버전 식별자를 나타냅니다. | 문자열 제약 조건: 최대 길이 = 100 |
apiVersionDescription | API 버전에 대한 설명입니다. | 문자열 제약 조건: 최대 길이 = 256 |
apiVersionSet | 버전 집합 세부 정보 | ApiVersionSetContractDetails |
apiVersionSetId | 관련 ApiVersionSet에 대한 리소스 식별자입니다. | 문자열 |
authenticationSettings | 이 API에 포함된 인증 설정의 컬렉션입니다. | AuthenticationSettingsContract |
접촉 | API에 대한 연락처 정보입니다. | ApiContactInformation |
묘사 | API에 대한 설명입니다. HTML 서식 태그를 포함할 수 있습니다. | 문자열 |
displayName | API 이름입니다. 길이는 1~300자여야 합니다. | 문자열 제약 조건: 최소 길이 = 1 최대 길이 = 300 |
판 | API를 가져오는 콘텐츠의 형식입니다. 나중에 새 형식을 추가할 수 있습니다. | 'graphql-link' 'grpc' 'grpc-link' 'odata' 'odata-link' 'openapi' 'openapi+json' 'openapi+json-link' 'openapi-link' 'swagger-json' 'swagger-link-json' 'wadl-link-json' 'wadl-xml' 'wsdl' 'wsdl-link' |
isCurrent | API 수정 버전이 현재 API 수정 버전인지를 나타냅니다. | bool |
면허 | API에 대한 라이선스 정보입니다. | ApiLicenseInformation |
길 | 이 API 및 API Management 서비스 인스턴스 내의 모든 리소스 경로를 고유하게 식별하는 상대 URL입니다. 서비스 인스턴스를 만드는 동안 지정된 API 엔드포인트 기본 URL에 추가되어 이 API에 대한 공용 URL을 형성합니다. | string(필수) 제약 조건: 최대 길이 = 400 |
프로토콜 | 이 API의 작업을 호출할 수 있는 프로토콜에 대해 설명합니다. | 다음 중 어느 것을 포함하는 문자열 배열: ' http '' https ''ws' 'wss' |
serviceUrl | 이 API를 구현하는 백 엔드 서비스의 절대 URL입니다. 2000자를 초과할 수 없습니다. | 문자열 제약 조건: 최대 길이 = 2000 |
sourceApiId | 원본 API의 API 식별자입니다. | 문자열 |
subscriptionKeyParameterNames | API를 사용할 수 있는 프로토콜입니다. | SubscriptionKeyParameterNamesContract |
subscriptionRequired | API에 액세스하는 데 API 또는 제품 구독이 필요한지 여부를 지정합니다. | bool |
termsOfServiceUrl | API에 대한 서비스 약관에 대한 URL입니다. URL 형식이어야 합니다. | 문자열 |
translateRequiredQueryParameters | 필요한 쿼리 매개 변수를 템플릿 매개 변수로 변환하는 전략입니다. 기본적으로 'template' 값이 있습니다. 가능한 값: 'template', 'query' | 'query' 'template' |
형 | API의 유형입니다. | 'graphql' 'grpc' ' http ''odata' 'soap' 'websocket' |
값 | API를 가져올 때의 콘텐츠 값입니다. | 문자열 |
wsdlSelector | WSDL의 가져오기를 문서의 하위 집합으로 제한하는 조건입니다. | ApiCreateOrUpdatePropertiesWsdlSelector |
ApiVersionSetContractDetails
이름 | 묘사 | 값 |
---|---|---|
묘사 | API 버전 집합에 대한 설명입니다. | 문자열 |
아이디 | 기존 API 버전 집합의 식별자입니다. 새 버전 집합을 만들려면 이 값을 생략합니다. | 문자열 |
이름 | API 버전 집합의 표시 이름입니다. | 문자열 |
versionHeaderName | versioningScheme이 header 설정된 경우 API 버전을 나타내는 HTTP 헤더 매개 변수의 이름입니다. |
문자열 |
versioningScheme | HTTP 요청에 API 버전 식별자를 배치할 위치를 결정하는 값입니다. | 'Header' 'Query' 'Segment' |
versionQueryName | versioningScheme이 query 설정된 경우 API 버전을 나타내는 쿼리 매개 변수의 이름입니다. |
문자열 |
AuthenticationSettingsContract
이름 | 묘사 | 값 |
---|---|---|
oAuth2 | OAuth2 인증 설정 | OAuth2AuthenticationSettingsContract |
oAuth2AuthenticationSettings | 이 API에 포함된 OAuth2 인증 설정의 컬렉션입니다. | OAuth2AuthenticationSettingsContract[] |
openid | OpenID Connect 인증 설정 | openIdAuthenticationSettingsContract |
openidAuthenticationSettings | 이 API에 포함된 Open ID Connect 인증 설정의 컬렉션입니다. | OpenIdAuthenticationSettingsContract |
OAuth2AuthenticationSettingsContract
이름 | 묘사 | 값 |
---|---|---|
authorizationServerId | OAuth 권한 부여 서버 식별자입니다. | 문자열 |
범위 | 작업 범위입니다. | 문자열 |
OpenIdAuthenticationSettingsContract
이름 | 묘사 | 값 |
---|---|---|
bearerTokenSendingMethods | 서버에 토큰을 보내는 방법입니다. | 다음 중 어느 것을 포함하는 문자열 배열: 'authorizationHeader' 'query' |
openidProviderId | OAuth 권한 부여 서버 식별자입니다. | 문자열 |
ApiContactInformation
이름 | 묘사 | 값 |
---|---|---|
메일 주소 | 연락처/조직의 전자 메일 주소입니다. 전자 메일 주소 형식이어야 합니다. | 문자열 |
이름 | 연락처/조직의 식별 이름 | 문자열 |
url | 연락처 정보를 가리키는 URL입니다. URL 형식이어야 합니다. | 문자열 |
ApiLicenseInformation
이름 | 묘사 | 값 |
---|---|---|
이름 | API에 사용되는 라이선스 이름 | 문자열 |
url | API에 사용되는 라이선스의 URL입니다. URL 형식이어야 합니다. | 문자열 |
SubscriptionKeyParameterNamesContract
이름 | 묘사 | 값 |
---|---|---|
머리글 | 구독 키 헤더 이름입니다. | 문자열 |
쿼리 | 구독 키 쿼리 문자열 매개 변수 이름입니다. | 문자열 |
ApiCreateOrUpdatePropertiesWsdlSelector
이름 | 묘사 | 값 |
---|---|---|
wsdlEndpointName | WSDL에서 가져올 엔드포인트(포트)의 이름 | 문자열 |
wsdlServiceName | WSDL에서 가져올 서비스 이름 | 문자열 |
ARM 템플릿 리소스 정의
다음을 대상으로 하는 작업으로 서비스/작업 영역/api 리소스 유형을 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.ApiManagement/service/workspaces/api 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.ApiManagement/service/workspaces/apis",
"apiVersion": "2023-09-01-preview",
"name": "string",
"properties": {
"apiRevision": "string",
"apiRevisionDescription": "string",
"apiType": "string",
"apiVersion": "string",
"apiVersionDescription": "string",
"apiVersionSet": {
"description": "string",
"id": "string",
"name": "string",
"versionHeaderName": "string",
"versioningScheme": "string",
"versionQueryName": "string"
},
"apiVersionSetId": "string",
"authenticationSettings": {
"oAuth2": {
"authorizationServerId": "string",
"scope": "string"
},
"oAuth2AuthenticationSettings": [
{
"authorizationServerId": "string",
"scope": "string"
}
],
"openid": {
"bearerTokenSendingMethods": [ "string" ],
"openidProviderId": "string"
},
"openidAuthenticationSettings": [
{
"bearerTokenSendingMethods": [ "string" ],
"openidProviderId": "string"
}
]
},
"contact": {
"email": "string",
"name": "string",
"url": "string"
},
"description": "string",
"displayName": "string",
"format": "string",
"isCurrent": "bool",
"license": {
"name": "string",
"url": "string"
},
"path": "string",
"protocols": [ "string" ],
"serviceUrl": "string",
"sourceApiId": "string",
"subscriptionKeyParameterNames": {
"header": "string",
"query": "string"
},
"subscriptionRequired": "bool",
"termsOfServiceUrl": "string",
"translateRequiredQueryParameters": "string",
"type": "string",
"value": "string",
"wsdlSelector": {
"wsdlEndpointName": "string",
"wsdlServiceName": "string"
}
}
}
속성 값
service/workspaces/api
이름 | 묘사 | 값 |
---|---|---|
형 | 리소스 종류 | 'Microsoft.ApiManagement/service/workspaces/api' |
apiVersion | 리소스 api 버전 | '2023-09-01-preview' |
이름 | 리소스 이름 JSON ARM 템플릿 |
string(필수) |
속성 | 업데이트 속성의 API 엔터티 만들기 | ApiCreateOrUpdatePropertiesOrApiContractProperties |
ApiCreateOrUpdatePropertiesOrApiContractProperties
이름 | 묘사 | 값 |
---|---|---|
apiRevision | API의 수정 버전에 대해 설명합니다. 값이 제공되지 않으면 기본 수정 버전 1이 생성됩니다. | 문자열 제약 조건: 최소 길이 = 1 최대 길이 = 100 |
apiRevisionDescription | API 수정 버전에 대한 설명입니다. | 문자열 제약 조건: 최대 길이 = 256 |
apiType | 만들 API의 유형입니다. * http REST API를 만듭니다. * soap SOAP 통과 API를 만듭니다. * websocket websocket API를 만듭니다. * graphql GraphQL API를 만듭니다. 나중에 새 형식을 추가할 수 있습니다. |
'graphql' 'grpc' ' http ''odata' 'soap' 'websocket' |
apiVersion | API 버전이 지정된 경우 API의 버전 식별자를 나타냅니다. | 문자열 제약 조건: 최대 길이 = 100 |
apiVersionDescription | API 버전에 대한 설명입니다. | 문자열 제약 조건: 최대 길이 = 256 |
apiVersionSet | 버전 집합 세부 정보 | ApiVersionSetContractDetails |
apiVersionSetId | 관련 ApiVersionSet에 대한 리소스 식별자입니다. | 문자열 |
authenticationSettings | 이 API에 포함된 인증 설정의 컬렉션입니다. | AuthenticationSettingsContract |
접촉 | API에 대한 연락처 정보입니다. | ApiContactInformation |
묘사 | API에 대한 설명입니다. HTML 서식 태그를 포함할 수 있습니다. | 문자열 |
displayName | API 이름입니다. 길이는 1~300자여야 합니다. | 문자열 제약 조건: 최소 길이 = 1 최대 길이 = 300 |
판 | API를 가져오는 콘텐츠의 형식입니다. 나중에 새 형식을 추가할 수 있습니다. | 'graphql-link' 'grpc' 'grpc-link' 'odata' 'odata-link' 'openapi' 'openapi+json' 'openapi+json-link' 'openapi-link' 'swagger-json' 'swagger-link-json' 'wadl-link-json' 'wadl-xml' 'wsdl' 'wsdl-link' |
isCurrent | API 수정 버전이 현재 API 수정 버전인지를 나타냅니다. | bool |
면허 | API에 대한 라이선스 정보입니다. | ApiLicenseInformation |
길 | 이 API 및 API Management 서비스 인스턴스 내의 모든 리소스 경로를 고유하게 식별하는 상대 URL입니다. 서비스 인스턴스를 만드는 동안 지정된 API 엔드포인트 기본 URL에 추가되어 이 API에 대한 공용 URL을 형성합니다. | string(필수) 제약 조건: 최대 길이 = 400 |
프로토콜 | 이 API의 작업을 호출할 수 있는 프로토콜에 대해 설명합니다. | 다음 중 어느 것을 포함하는 문자열 배열: ' http '' https ''ws' 'wss' |
serviceUrl | 이 API를 구현하는 백 엔드 서비스의 절대 URL입니다. 2000자를 초과할 수 없습니다. | 문자열 제약 조건: 최대 길이 = 2000 |
sourceApiId | 원본 API의 API 식별자입니다. | 문자열 |
subscriptionKeyParameterNames | API를 사용할 수 있는 프로토콜입니다. | SubscriptionKeyParameterNamesContract |
subscriptionRequired | API에 액세스하는 데 API 또는 제품 구독이 필요한지 여부를 지정합니다. | bool |
termsOfServiceUrl | API에 대한 서비스 약관에 대한 URL입니다. URL 형식이어야 합니다. | 문자열 |
translateRequiredQueryParameters | 필요한 쿼리 매개 변수를 템플릿 매개 변수로 변환하는 전략입니다. 기본적으로 'template' 값이 있습니다. 가능한 값: 'template', 'query' | 'query' 'template' |
형 | API의 유형입니다. | 'graphql' 'grpc' ' http ''odata' 'soap' 'websocket' |
값 | API를 가져올 때의 콘텐츠 값입니다. | 문자열 |
wsdlSelector | WSDL의 가져오기를 문서의 하위 집합으로 제한하는 조건입니다. | ApiCreateOrUpdatePropertiesWsdlSelector |
ApiVersionSetContractDetails
이름 | 묘사 | 값 |
---|---|---|
묘사 | API 버전 집합에 대한 설명입니다. | 문자열 |
아이디 | 기존 API 버전 집합의 식별자입니다. 새 버전 집합을 만들려면 이 값을 생략합니다. | 문자열 |
이름 | API 버전 집합의 표시 이름입니다. | 문자열 |
versionHeaderName | versioningScheme이 header 설정된 경우 API 버전을 나타내는 HTTP 헤더 매개 변수의 이름입니다. |
문자열 |
versioningScheme | HTTP 요청에 API 버전 식별자를 배치할 위치를 결정하는 값입니다. | 'Header' 'Query' 'Segment' |
versionQueryName | versioningScheme이 query 설정된 경우 API 버전을 나타내는 쿼리 매개 변수의 이름입니다. |
문자열 |
AuthenticationSettingsContract
이름 | 묘사 | 값 |
---|---|---|
oAuth2 | OAuth2 인증 설정 | OAuth2AuthenticationSettingsContract |
oAuth2AuthenticationSettings | 이 API에 포함된 OAuth2 인증 설정의 컬렉션입니다. | OAuth2AuthenticationSettingsContract[] |
openid | OpenID Connect 인증 설정 | openIdAuthenticationSettingsContract |
openidAuthenticationSettings | 이 API에 포함된 Open ID Connect 인증 설정의 컬렉션입니다. | OpenIdAuthenticationSettingsContract |
OAuth2AuthenticationSettingsContract
이름 | 묘사 | 값 |
---|---|---|
authorizationServerId | OAuth 권한 부여 서버 식별자입니다. | 문자열 |
범위 | 작업 범위입니다. | 문자열 |
OpenIdAuthenticationSettingsContract
이름 | 묘사 | 값 |
---|---|---|
bearerTokenSendingMethods | 서버에 토큰을 보내는 방법입니다. | 다음 중 어느 것을 포함하는 문자열 배열: 'authorizationHeader' 'query' |
openidProviderId | OAuth 권한 부여 서버 식별자입니다. | 문자열 |
ApiContactInformation
이름 | 묘사 | 값 |
---|---|---|
메일 주소 | 연락처/조직의 전자 메일 주소입니다. 전자 메일 주소 형식이어야 합니다. | 문자열 |
이름 | 연락처/조직의 식별 이름 | 문자열 |
url | 연락처 정보를 가리키는 URL입니다. URL 형식이어야 합니다. | 문자열 |
ApiLicenseInformation
이름 | 묘사 | 값 |
---|---|---|
이름 | API에 사용되는 라이선스 이름 | 문자열 |
url | API에 사용되는 라이선스의 URL입니다. URL 형식이어야 합니다. | 문자열 |
SubscriptionKeyParameterNamesContract
이름 | 묘사 | 값 |
---|---|---|
머리글 | 구독 키 헤더 이름입니다. | 문자열 |
쿼리 | 구독 키 쿼리 문자열 매개 변수 이름입니다. | 문자열 |
ApiCreateOrUpdatePropertiesWsdlSelector
이름 | 묘사 | 값 |
---|---|---|
wsdlEndpointName | WSDL에서 가져올 엔드포인트(포트)의 이름 | 문자열 |
wsdlServiceName | WSDL에서 가져올 서비스 이름 | 문자열 |
Terraform(AzAPI 공급자) 리소스 정의
다음을 대상으로 하는 작업으로 서비스/작업 영역/api 리소스 유형을 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.ApiManagement/service/workspaces/api 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ApiManagement/service/workspaces/apis@2023-09-01-preview"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
apiRevision = "string"
apiRevisionDescription = "string"
apiType = "string"
apiVersion = "string"
apiVersionDescription = "string"
apiVersionSet = {
description = "string"
id = "string"
name = "string"
versionHeaderName = "string"
versioningScheme = "string"
versionQueryName = "string"
}
apiVersionSetId = "string"
authenticationSettings = {
oAuth2 = {
authorizationServerId = "string"
scope = "string"
}
oAuth2AuthenticationSettings = [
{
authorizationServerId = "string"
scope = "string"
}
]
openid = {
bearerTokenSendingMethods = [
"string"
]
openidProviderId = "string"
}
openidAuthenticationSettings = [
{
bearerTokenSendingMethods = [
"string"
]
openidProviderId = "string"
}
]
}
contact = {
email = "string"
name = "string"
url = "string"
}
description = "string"
displayName = "string"
format = "string"
isCurrent = bool
license = {
name = "string"
url = "string"
}
path = "string"
protocols = [
"string"
]
serviceUrl = "string"
sourceApiId = "string"
subscriptionKeyParameterNames = {
header = "string"
query = "string"
}
subscriptionRequired = bool
termsOfServiceUrl = "string"
translateRequiredQueryParameters = "string"
type = "string"
value = "string"
wsdlSelector = {
wsdlEndpointName = "string"
wsdlServiceName = "string"
}
}
})
}
속성 값
service/workspaces/api
이름 | 묘사 | 값 |
---|---|---|
형 | 리소스 종류 | "Microsoft.ApiManagement/service/workspaces/apis@2023-09-01-preview" |
이름 | 리소스 이름 | string(필수) |
parent_id | 이 리소스의 부모인 리소스의 ID입니다. | 형식 리소스의 ID: 작업 영역 |
속성 | 업데이트 속성의 API 엔터티 만들기 | ApiCreateOrUpdatePropertiesOrApiContractProperties |
ApiCreateOrUpdatePropertiesOrApiContractProperties
이름 | 묘사 | 값 |
---|---|---|
apiRevision | API의 수정 버전에 대해 설명합니다. 값이 제공되지 않으면 기본 수정 버전 1이 생성됩니다. | 문자열 제약 조건: 최소 길이 = 1 최대 길이 = 100 |
apiRevisionDescription | API 수정 버전에 대한 설명입니다. | 문자열 제약 조건: 최대 길이 = 256 |
apiType | 만들 API의 유형입니다. * http REST API를 만듭니다. * soap SOAP 통과 API를 만듭니다. * websocket websocket API를 만듭니다. * graphql GraphQL API를 만듭니다. 나중에 새 형식을 추가할 수 있습니다. |
"graphql" "grpc" " http ""odata" "soap" "websocket" |
apiVersion | API 버전이 지정된 경우 API의 버전 식별자를 나타냅니다. | 문자열 제약 조건: 최대 길이 = 100 |
apiVersionDescription | API 버전에 대한 설명입니다. | 문자열 제약 조건: 최대 길이 = 256 |
apiVersionSet | 버전 집합 세부 정보 | ApiVersionSetContractDetails |
apiVersionSetId | 관련 ApiVersionSet에 대한 리소스 식별자입니다. | 문자열 |
authenticationSettings | 이 API에 포함된 인증 설정의 컬렉션입니다. | AuthenticationSettingsContract |
접촉 | API에 대한 연락처 정보입니다. | ApiContactInformation |
묘사 | API에 대한 설명입니다. HTML 서식 태그를 포함할 수 있습니다. | 문자열 |
displayName | API 이름입니다. 길이는 1~300자여야 합니다. | 문자열 제약 조건: 최소 길이 = 1 최대 길이 = 300 |
판 | API를 가져오는 콘텐츠의 형식입니다. 나중에 새 형식을 추가할 수 있습니다. | "graphql-link" "grpc" "grpc-link" "odata" "odata-link" "openapi" "openapi+json" "openapi+json-link" "openapi-link" "swagger-json" "swagger-link-json" "wadl-link-json" "wadl-xml" "wsdl" "wsdl-link" |
isCurrent | API 수정 버전이 현재 API 수정 버전인지를 나타냅니다. | bool |
면허 | API에 대한 라이선스 정보입니다. | ApiLicenseInformation |
길 | 이 API 및 API Management 서비스 인스턴스 내의 모든 리소스 경로를 고유하게 식별하는 상대 URL입니다. 서비스 인스턴스를 만드는 동안 지정된 API 엔드포인트 기본 URL에 추가되어 이 API에 대한 공용 URL을 형성합니다. | string(필수) 제약 조건: 최대 길이 = 400 |
프로토콜 | 이 API의 작업을 호출할 수 있는 프로토콜에 대해 설명합니다. | 다음 중 어느 것을 포함하는 문자열 배열: " http "" https ""ws" "wss" |
serviceUrl | 이 API를 구현하는 백 엔드 서비스의 절대 URL입니다. 2000자를 초과할 수 없습니다. | 문자열 제약 조건: 최대 길이 = 2000 |
sourceApiId | 원본 API의 API 식별자입니다. | 문자열 |
subscriptionKeyParameterNames | API를 사용할 수 있는 프로토콜입니다. | SubscriptionKeyParameterNamesContract |
subscriptionRequired | API에 액세스하는 데 API 또는 제품 구독이 필요한지 여부를 지정합니다. | bool |
termsOfServiceUrl | API에 대한 서비스 약관에 대한 URL입니다. URL 형식이어야 합니다. | 문자열 |
translateRequiredQueryParameters | 필요한 쿼리 매개 변수를 템플릿 매개 변수로 변환하는 전략입니다. 기본적으로 'template' 값이 있습니다. 가능한 값: 'template', 'query' | "query" "template" |
형 | API의 유형입니다. | "graphql" "grpc" " http ""odata" "soap" "websocket" |
값 | API를 가져올 때의 콘텐츠 값입니다. | 문자열 |
wsdlSelector | WSDL의 가져오기를 문서의 하위 집합으로 제한하는 조건입니다. | ApiCreateOrUpdatePropertiesWsdlSelector |
ApiVersionSetContractDetails
이름 | 묘사 | 값 |
---|---|---|
묘사 | API 버전 집합에 대한 설명입니다. | 문자열 |
아이디 | 기존 API 버전 집합의 식별자입니다. 새 버전 집합을 만들려면 이 값을 생략합니다. | 문자열 |
이름 | API 버전 집합의 표시 이름입니다. | 문자열 |
versionHeaderName | versioningScheme이 header 설정된 경우 API 버전을 나타내는 HTTP 헤더 매개 변수의 이름입니다. |
문자열 |
versioningScheme | HTTP 요청에 API 버전 식별자를 배치할 위치를 결정하는 값입니다. | "헤더" "쿼리" "세그먼트" |
versionQueryName | versioningScheme이 query 설정된 경우 API 버전을 나타내는 쿼리 매개 변수의 이름입니다. |
문자열 |
AuthenticationSettingsContract
이름 | 묘사 | 값 |
---|---|---|
oAuth2 | OAuth2 인증 설정 | OAuth2AuthenticationSettingsContract |
oAuth2AuthenticationSettings | 이 API에 포함된 OAuth2 인증 설정의 컬렉션입니다. | OAuth2AuthenticationSettingsContract[] |
openid | OpenID Connect 인증 설정 | openIdAuthenticationSettingsContract |
openidAuthenticationSettings | 이 API에 포함된 Open ID Connect 인증 설정의 컬렉션입니다. | OpenIdAuthenticationSettingsContract |
OAuth2AuthenticationSettingsContract
이름 | 묘사 | 값 |
---|---|---|
authorizationServerId | OAuth 권한 부여 서버 식별자입니다. | 문자열 |
범위 | 작업 범위입니다. | 문자열 |
OpenIdAuthenticationSettingsContract
이름 | 묘사 | 값 |
---|---|---|
bearerTokenSendingMethods | 서버에 토큰을 보내는 방법입니다. | 다음 중 어느 것을 포함하는 문자열 배열: "authorizationHeader" "query" |
openidProviderId | OAuth 권한 부여 서버 식별자입니다. | 문자열 |
ApiContactInformation
이름 | 묘사 | 값 |
---|---|---|
메일 주소 | 연락처/조직의 전자 메일 주소입니다. 전자 메일 주소 형식이어야 합니다. | 문자열 |
이름 | 연락처/조직의 식별 이름 | 문자열 |
url | 연락처 정보를 가리키는 URL입니다. URL 형식이어야 합니다. | 문자열 |
ApiLicenseInformation
이름 | 묘사 | 값 |
---|---|---|
이름 | API에 사용되는 라이선스 이름 | 문자열 |
url | API에 사용되는 라이선스의 URL입니다. URL 형식이어야 합니다. | 문자열 |
SubscriptionKeyParameterNamesContract
이름 | 묘사 | 값 |
---|---|---|
머리글 | 구독 키 헤더 이름입니다. | 문자열 |
쿼리 | 구독 키 쿼리 문자열 매개 변수 이름입니다. | 문자열 |
ApiCreateOrUpdatePropertiesWsdlSelector
이름 | 묘사 | 값 |
---|---|---|
wsdlEndpointName | WSDL에서 가져올 엔드포인트(포트)의 이름 | 문자열 |
wsdlServiceName | WSDL에서 가져올 서비스 이름 | 문자열 |