Timezone - Get Timezone Windows To IANA
IANA ID를 가져오는 데 사용합니다.
Get Windows to IANA Time Zone API는 유효한 Windows 표준 시간대 ID가 지정된 경우 해당 IANA(Internet Assigned Numbers Authority) ID를 반환하는 HTTP GET 요청입니다. Windows ID 하나에 여러 IANA ID가 반환될 수 있습니다. 선택적 영역 매개 변수를 추가하여 이러한 결과의 범위를 좁힐 수 있습니다.
GET https://atlas.microsoft.com/timezone/windowsToIana/json?api-version=1.0&query={query}
GET https://atlas.microsoft.com/timezone/windowsToIana/json?api-version=1.0&query={query}&territory={territory}
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
format
|
path | True |
원하는 응답 형식입니다.
|
|
|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호입니다. |
|
query
|
query | True |
string |
Windows 표준 시간대 ID입니다. |
|
territory
|
query |
string |
Windows 표준 시간대 지역 코드입니다. |
요청 헤더
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| x-ms-client-id |
string |
Microsoft Entra ID 보안 모델과 함께 사용할 계정을 나타냅니다. Azure Maps 계정에 대한 이 고유 ID는 Azure Maps 관리 평면 계정 API에서 가져올 수 있습니다. Azure Maps에서 Microsoft Entra ID 보안을 사용하는 방법에 대한 자세한 내용은 Azure Maps에서 인증 관리를 참조하세요. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
Iana |
그래 |
| Other Status Codes |
예기치 않은 오류가 발생했습니다. |
보안
AADToken
다음은 Microsoft Entra OAuth 2.0 흐름에
시나리오를 구현하려면
비고
- 이 보안 정의
x-ms-client-id헤더를 사용하여 애플리케이션이 액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 Maps 관리 API가져올 수 있습니다.
Authorization URL Azure 퍼블릭 클라우드 인스턴스와 관련이 있습니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다.
* Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다.
* Azure Maps Web SDK 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.
- Microsoft ID 플랫폼에 대한 자세한 내용은 Microsoft ID 플랫폼 개요참조하세요.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | Description |
|---|---|
| https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Azure Portal에서 Azure Maps 계정 만들거나 PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.
이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키를 발급된 계정에서 마스터 키로 사용할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 키를 안전하게 저장할 수 있도록 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 Azure Maps REST API에 액세스하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
query
SAS Token
공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해
이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어를 사용하여 액세스하고 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어 권한을 부여받습니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 허용된 원본의 특정 목록을 구성하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
header
예제
Successfully retrieve corresponding timezone Iana
샘플 요청
GET https://atlas.microsoft.com/timezone/windowsToIana/json?api-version=1.0&query=pacific standard time
샘플 응답
[
{
"Id": "America/Los_Angeles",
"IsAlias": false,
"HasZone1970Location": true
}
]
정의
| Name | Description |
|---|---|
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
Iana |
|
|
Json |
원하는 응답 형식입니다.
|
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
object |
추가 정보입니다. |
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
IanaId
| Name | 형식 | Description |
|---|---|---|
| AliasOf |
string |
AliasOf 속성 |
| HasZone1970Location |
boolean |
이 특성은 IanaId에 연결된 국가/영역이 있는 경우 |
| Id |
string |
Id 속성 |
| IsAlias |
boolean |
IsAlias 속성 |
JsonFormat
원하는 응답 형식입니다.
json 형식만 지원됩니다.
| 값 | Description |
|---|---|
| json |