Weather - Get Tropical Storm Active

Gebruik om een lijst te krijgen van de actieve tropische stormen die zijn uitgegeven door nationale weersvoorspellingsbureaus.
De Get Tropical Storm Active API is een HTTP-verzoek GET dat een lijst retourneert van alle door de overheid uitgegeven actieve tropische stormen. Informatie over de tropische stormen omvat: overheids-ID, bekken-ID, jaar van herkomst, naam en of het subtropisch is.

GET {endpoint}/weather/tropical/storms/active/json?api-version=1.1

URI-parameters

Aanvraagkoptekst

Antwoorden

Beveiliging

AadToken

Dit zijn de Microsoft Entra OAuth 2.0 stromen. In combinatie met Azure rolgebaseerde toegang control kan het worden gebruikt om de toegang tot Azure Maps REST-API's te controleren. Azure rolgebaseerde toegangscontroles worden gebruikt om toegang aan een of meer Azure Maps-resourceaccounts of subresources aan te wijzen. Elke gebruiker, groep of service-principal kan toegang krijgen via een ingebouwde rol of een aangepaste rol die bestaat uit een of meer machtigingen voor Azure Maps REST API's.

Voor het implementeren van scenario's raden we u aan om verificatieconceptente bekijken. Kortom, deze beveiligingsdefinitie biedt een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen uitvoeren voor specifieke API's en bereiken.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

subscription-key

Dit is een gedeelde sleutel die wordt ingericht wanneer u Een Azure Maps-account maken in Azure Portal of met behulp van PowerShell, CLI, Azure SDK's of REST API.

Met deze sleutel heeft elke toepassing toegang tot alle REST API's. Met andere woorden, deze sleutel kan worden gebruikt als een hoofdsleutel in het account waarin ze worden uitgegeven.

Voor openbaar blootgestelde toepassingen is het raadzaam om de vertrouwelijke clienttoepassingen te gebruiken benadering voor toegang tot Azure Maps REST API's, zodat uw sleutel veilig kan worden opgeslagen.

Type: apiKey
In: header

SAS Token

Dit is een shared access Signature-token dat wordt gemaakt op basis van de bewerking List SAS op de Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.

Met dit token is elke toepassing gemachtigd voor toegang met op rollen gebaseerd toegangsbeheer van Azure en gedetailleerd beheer tot de vervaldatum, snelheid en regio(s) van gebruik voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen toe te staan toegang op een veiligere manier te beheren dan de gedeelde sleutel.

Voor openbaar blootgestelde toepassingen wordt aangeraden een specifieke lijst met toegestane origins te configureren voor de resource van het Account toewijzen om het genereren van misbruik te beperken en het SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

Get Tropical Storm Active

GET https://atlas.microsoft.com/weather/tropical/storms/active/json?api-version=1.1

{
  "results": [
    {
      "name": "Hilda",
      "basinId": "EP",
      "govId": 8,
      "isActive": true,
      "isSubtropical": false,
      "year": "2021"
    },
    {
      "name": "TD 9E",
      "basinId": "EP",
      "govId": 9,
      "isActive": true,
      "isSubtropical": false,
      "year": "2021"
    },
    {
      "name": "TWELVE",
      "basinId": "NP",
      "govId": 12,
      "isActive": true,
      "isSubtropical": false,
      "year": "2021"
    },
    {
      "name": "LUPIT",
      "basinId": "NP",
      "govId": 13,
      "isActive": true,
      "isSubtropical": false,
      "year": "2021"
    },
    {
      "name": "FOURTEEN",
      "basinId": "NP",
      "govId": 14,
      "isActive": true,
      "isSubtropical": false,
      "year": "2021"
    },
    {
      "name": "FIFTEEN",
      "basinId": "NP",
      "govId": 15,
      "isActive": true,
      "isSubtropical": false,
      "year": "2021"
    }
  ]
}

Definities

ActiveStorm

Geeft essentiële details over lopende tropische stormen, zoals gerapporteerd door nationale weersvoorspellingsinstanties.

ActiveStormResult

Het ActiveStormResult-object biedt uitgebreide informatie over lopende tropische stormen. Het bevat een array van ActiveStorm-objecten , elk met specifieke kenmerken van individuele stormen. Deze kenmerken omvatten het overheids-ID, het bekken-ID, het ontstaansjaar, de naam en de subtropische status van de storm.

BasinId

Bekkenidentificatie voor tropische stormen.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Veelvoorkomende foutrespons voor alle Azure Resource Manager API's om foutdetails terug te geven bij mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)

JsonFormat

Gewenste indeling van het antwoord. Alleen json indeling wordt ondersteund.