Timezone - Get Timezone By ID

Используется для получения информации о текущем, историческом и будущем часовом поясе для указанного идентификатора часового пояса IANA.
API Get Timezone By ID — это запрос HTTP GET, который возвращает текущие, исторические и будущие сведения часового пояса для указанного идентификатора часового пояса IANA.

GET {endpoint}/timezone/byId/json?api-version=1.0&query={query}

GET {endpoint}/timezone/byId/json?api-version=1.0&options={options}&timeStamp={timeStamp}&transitionsFrom={transitionsFrom}&transitionsYears={transitionsYears}&query={query}

Параметры URI

Заголовок запроса

Ответы

Безопасность

AadToken

Это Microsoft Entra OAuth 2.0 потоки. В сочетании с управлением Azure ролевым доступом он может использоваться для управления доступом к Azure Maps REST API. Ролевые контроли доступа Azure используются для обозначения доступа к одной или нескольким учетной записи ресурсов или подресурсам Azure Maps. Любой пользователь, группа или принципал сервиса может получить доступ через встроенную роль или пользовательскую роль, состоящую из одного или нескольких разрешений Azure Maps REST API.\n\nДля реализации сценариев рекомендуем ознакомиться с концепциями аутентификационные концепции. В заключение, это определение безопасности предоставляет решение для моделирования приложений с помощью объектов, способных контролировать доступ к определённым API и областям видимости.\n\n#### Примечания\n* Это определение безопасности требует использование заголовка x-ms-client-id для указания, к какому Azure Maps ресурсу приложение запрашивает доступ. Её можно получить через API управления Maps.\n* \nAuthorization URL специфичен для экземпляра публичного облака Azure. Облака Sovereign имеют уникальные URL-адреса авторизации и конфигурации Microsoft Entra ID. \n* \nУправление доступом на основе ролей Azure настраивается с плоскости управления Azure через портал Azure, PowerShell, CLI, Azure SDKs или REST API.\n* \nИспользование Azure Maps Web SDK позволяет настраивать приложение на основе конфигурации для нескольких сценариев использования.\n* Для получения дополнительной информации о платформа удостоверений Майкрософт см. платформа удостоверений Майкрософт обзор.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

subscription-key

Это общий ключ, который создаётся при Создайте Azure Maps аккаунт в Azure-портале или с помощью PowerShell, CLI, Azure SDKs или REST API.\n\n С помощью этого ключа любое приложение может получить доступ ко всем REST API. Другими словами, этот ключ может использоваться как мастер-ключ на счете, на котором они выпущены.\n\n Для публично открытых приложений мы рекомендуем использовать подход confidential client applications для доступа к Azure Maps REST API, чтобы ваш ключ можно было безопасно хранить.

Тип: apiKey
В: header

SAS Token

Это токен общего доступа, созданный из операции List SAS на ресурсе Azure Maps/c0> через плоскость управления Azure через портал Azure, PowerShell, CLI, Azure SDKs или REST API.\n\n С помощью этого токена любое приложение имеет право на доступ с помощью Azure ролевые контроли доступа и тонкий контроль истечения срока действия, скорости и региона использования конкретного токена. Другими словами, SAS Token может использоваться для того, чтобы приложения могли управлять доступом более защищённо, чем общий ключ.\n\n Для публично открытых приложений мы рекомендуем настроить конкретный список разрешённых источников на ресурсе аккаунта Map , чтобы ограничить злоупотребления рендерингом и регулярно продлевать токен SAS.

Тип: apiKey
В: header

Примеры

Successfully retrieve timezone by ID

GET {endpoint}/timezone/byId/json?api-version=1.0&options=all&query=Asia/Bahrain

{
  "referenceUtcTimestamp": "2018-01-31T00:03:15.1349348Z",
  "timeZones": [
    {
      "aliases": [
        "Asia/Bahrain"
      ],
      "countries": [
        {
          "code": "QA",
          "name": "Qatar"
        },
        {
          "code": "BH",
          "name": "Bahrain"
        }
      ],
      "id": "Asia/Qatar",
      "names": {
        "daylight": "Arabian Daylight Time",
        "generic": "Arabian Time",
        "iso6391LanguageCode": "en",
        "standard": "Arabian Standard Time"
      },
      "referenceTime": {
        "daylightSavings": "00:00:00",
        "posixTz": "<+03>-3",
        "posixTzValidYear": 2018,
        "standardOffset": "03:00:00",
        "tag": "+03",
        "wallTime": "2018-01-31T03:03:15.1349348+03:00"
      },
      "representativePoint": {
        "latitude": 25.283333333333335,
        "longitude": 51.53333333333333
      },
      "timeTransitions": [
        {
          "daylightSavings": "00:00:00",
          "standardOffset": "03:00:00",
          "tag": "+03",
          "utcEnd": "9999-12-31T23:59:59.9999999Z",
          "utcStart": "1972-05-31T20:00:00Z"
        }
      ]
    }
  ],
  "version": "2018c"
}

Определения

CountryRecord

Запись страны или региона.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Обычный ответ на ошибку для всех API Azure Resource Manager для возврата деталей ошибок при неудачных операциях. (Это также следует формату ответа об ошибках OData.).

JsonFormat

Требуемый формат ответа. Поддерживается только json формат.

ReferenceTime

Сведения о действии в локальное время.

RepresentativePoint

Свойство Репрезентативной точки

TimeTransition

Обозначает переход между часовыми поясами.

TimezoneId

Информация о часовом поясе.

TimezoneNames

Объект имен часового пояса.

TimezoneOptions

Варианты информации о часовом поясе возвращаются в результате.

TimezoneResult

Этот объект возвращается из успешного вызова Часового пояса по идентификатору или по координатам